---
name: "XvStopVideo"
section: "3x"
platform: "linux"
package: "libxv-dev"
version: "1:1.0.2-1"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/XvStopVideo/3x"
---

# XvStopVideo(3x)

stop active video

## Name

XvStopVideo - stop active video

## Syntax

**#include \<X11/extensions/Xvlib.h\>**

**XvStopVideo(***dpy, port, draw*)

**Display** *\*dpy*;\
 **XvPortID** *port*;\
 **Drawable** *draw*;

## Arguments

- *dpy*

  Specifies the connection to the X server.

- *port*

  Specifies the port for which video is to be stopped.

- *draw*

  Specifies the drawable associated with the named port.

## Description

[XvStopVideo(3x)](/XvStopVideo/3x.md) 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)](/XvVideoNotify/3x.md) event with detail XvStopped is generated for the associated drawable.

## Returned Values

- \[Success\]

  Returned if [XvStopVideo(3x)](/XvStopVideo/3x.md) completed successfully.

- \[XvBadExtension\]

  Returned if the Xv extension is unavailable.

- \[XvBadAlloc\]

  Returned if [XvStopVideo(3x)](/XvStopVideo/3x.md) 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)](/XvGetVideo/3x.md), [XvPutVideo(3x)](/XvPutVideo/3x.md), XvVideoNotifyEvent(3x)\