XvQueryPortAttributes(3)

XvQueryPortAttributes3

Return list of attributes of a video port

Usage

#include <X11/extensions/Xvlib.h>

XvAttribute* XvQueryPortAttributes(Display *dpy,
                 XvPortID port,  int *p_num_attributes);

Arguments

dpy

Specifies the connection to the X server.

port

Specifies the port whose adaptor is to be queried for its list of attributes.

p_num_attributes

A pointer to where the number of attributes returned in the array is written.

Overview

XvQueryPortAttributes(3)returnsthenumberofattributes and an array of XvAttributes valid for the given port. The array may be freed with XFree(3).

Return values

XvAttribute has the following structure:

    typedef struct {
      int flags;
      int min_value;
      int max_value;
      char *name;
    } XvAttribute;
flags

May be XvGettable or XvSettable or both OR'd together indicating the particular attribute is readable, writeable or readable and writeable.

min_value

The minimum attribute values which are valid for the driver.

The maximum attribute values which are valid for the driver.

name

A string describing the name of the attribute that may be used to retrieve the Atom for the particular attribute.

Diagnostics

[XvBadPort]

Generated if the requested port does not exist.

Releases

9 releases since Debian 6.0 (Squeeze); the text changed 4 times.

  1. 6.0
  2. 7
  3. 8
  4. 9–13
  5. Arch

From libxv 1.0.13-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.