gtk:media-stream-realize (stream surface)

stream -- a gtk:media-stream object
surface -- a gdk:surface object

Called by users to attach the media stream to a gdk:surface object they manage. The stream can then access the resources of surface for its rendering purposes. In particular, media streams might want to create gdk:gl-context objects or sync to the gdk:frame-clock object.

Whoever calls this function is responsible for calling the gtk:media-stream-unrealize function before either the stream or surface get destroyed.

Multiple calls to this function may happen from different users of the video, even with the same surface . Each of these calls must be followed by its own call to the gtk:media-stream-unrealize function.

It is not required to call this function to make a media stream work.