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

# XvVideoNotify(3)

event generated for video processing

## NAME

XvVideoNotify - event generated for video processing

## SYNOPSIS

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

```
     typedef union {
       int type;
       XvVideoNotifyEvent xvvideo;
       XvPortNotifyEvent xvport;
       long pad[24];
     } XvEvent;
     typedef struct {
       int type;
       unsigned long serial;
       Bool send_event;
       Display *display;
       Drawable drawable;
       unsigned long reason;
       XvPortID port_id;
       Time time;
     } XvVideoNotifyEvent;
```

- *type*

  Specifies the type of event: **XvVideoNotify**.

- *serial*

  Number of the last request processed by the server.

- *send\_event*

  True if the event was generated by a SendEvent request.

- *display*

  A pointer to the display the event was read from.

- *drawable*

  The drawable for which the event was generated.

- *reason*

  The reason the event was generated: **XvStarted**, **XvStopped**, **XvPreempted**, **XvBusy**, **XvHardError**.

- *port\_id*

  The port processing the video for which the event was generated.

## DESCRIPTION

**XvVideoNotify** events are generated when video is started, stopped, preempted by another video request, ignored because the port is grabbed by another client, or interrupted because of a hard transmission or reception error.

## SEE ALSO

[**XvPutVideo**(3)](/XvPutVideo/3.md), [**XvPutStill**(3)](/XvPutStill/3.md), [**XvGetVideo**(3)](/XvGetVideo/3.md), [**XvGetStill**(3)](/XvGetStill/3.md), [**XvStopVideo**(3)](/XvStopVideo/3.md), [**XvSelectVideoNotify**(3)](/XvSelectVideoNotify/3.md)