---
name: "XvStopVideo"
section: "3"
platform: "linux"
package: "libxv"
version: "1.0.13-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/XvStopVideo"
---

# XvStopVideo(3)

stop active video

## NAME

XvStopVideo - stop active video

## SYNOPSIS

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

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

## RETURN VALUES

- \[Success\]

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

- \[XvBadExtension\]

  Returned if the Xv extension is unavailable.

- \[XvBadAlloc\]

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