.TH XvStopVideo 3 "libXv 1.0.12" "X Version 11" "libXv Functions"
.SH NAME
XvStopVideo \- stop active video
.\"
.SH SYNOPSIS
.B #include <X11/extensions/Xvlib.h>
.sp
.nf
.BI "int XvStopVideo(Display *" dpy ", XvPortID " port ", Drawable " draw ");"
.fi
.SH ARGUMENTS
.\"
.IP \fIdpy\fR 8
Specifies the connection to the X server.
.IP \fIport\fR 8
Specifies the port for which video is to be stopped.
.IP \fIdraw\fR 8
Specifies the drawable associated with the named port.
.SH DESCRIPTION
.\"
.BR XvStopVideo (3)
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
.BR XvVideoNotify (3)
event with detail XvStopped is generated for the associated drawable.
.\"
.SH RETURN VALUES
.IP [Success] 8
Returned if
.BR XvStopVideo (3)
completed successfully.
.IP [XvBadExtension] 8
Returned if the Xv extension is unavailable.
.IP [XvBadAlloc] 8
Returned if
.BR XvStopVideo (3)
failed to allocate memory to process the request.
.SH DIAGNOSTICS
.IP [XvBadPort] 8
Generated if the requested port does not exist.
.IP [BadDrawable] 8
Generated if the requested drawable does not exist.
.\"
.SH SEE ALSO
.BR XvGetVideo (3),
.BR XvPutVideo (3),
.BR XvVideoNotify (3)