Name

XvStopVideo - stop active video

Syntax

##iinncclluuddee <> <><> XXvvSSttooppVViiddeeoo((_d_p_y_, _p_o_r_t_, _d_r_a_w)

DDiissppllaayy _*_d_p_y;
XXvvPPoorrttIIDD _p_o_r_t;
DDrraawwaabbllee _d_r_a_w;

Arguments

_d_p_y Specifies the display screen on which the
Xv Server is to accept requests from Xv clients. If the display option is not specified, Xv uses the display screen specified by your DISPLAY environment variable. The display option has the format hostname:number. Using two colons (::) instead of one (:) indicates that DECnet is to be used for transport.
_p_o_r_t Specifies the port for which video is to be stopped.
_d_r_a_w Specifies the drawable associated with the named port.

Description

XvStopVideo(3X) stops active video for the specified port and drawable. If the port is not processing video, or if it is processing video in a different drawable, the request is ignored. When video is stopped a XvVideoNotify(3X) event with detail XvStopped is generated for the associated drawable.

Returned Values

[Success] Returned if XvStopVideo(3X) completed successfully.
[XvBadExtension] Returned if the Xv extension is unavailable.
[XvBadAlloc] Returned if XvStopVideo(3X) failed to allocate memory to process
the request.

Diagnostics

[XvBadPort] Generated if the requested port does not exist.
[BadDrawable] Generated if the requested drawable does not exist.

See Also

XvGetVideo(3X), XvPutVideo(3X), XvVideoNotifyEvent(3X)