XvGetPortAttribute(3) libXv Functions XvGetPortAttribute(3)

# [NAME](#NAME)

XvGetPortAttribute - return current port attribute value

# [SYNOPSIS](#SYNOPSIS)

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

```
int XvGetPortAttribute(Display *dpy, XvPortID port,
                       Atom attribute, int p_value);
```

# [ARGUMENTS](#ARGUMENTS)

[*dpy*](#dpy)

Specifies the connection to the X server.

[*port*](#port)

Specifies the port, associated with the given display, for which the attribute values are to be returned.

[*attribute*](#attribute)

An atom that identifies the attribute to be queried by this request. Control atoms are obtained using the XInternAtom request with a string from the following table.

[*p\_value*](#p_value)

Pointer to the location where the attribute value is written on return.

# [DESCRIPTION](#DESCRIPTION)

[**XvGetPortAttribute**(3)](/man/os/libxv/XvGetPortAttribute.3) returns the current value of the requested port attribute in the integer pointed to by *p\_value*. The attribute is identified using an Atom that equates to the attribute name. The XInternAtom request can be used with one of the strings below to return a matching Atom.

Attribute String Type Default "XV\_ENCODING" XvEncodingID Server dependent "XV\_HUE" \[-1000...1000] 0 "XV\_SATURATION" \[-1000...1000] 0 "XV\_BRIGHTNESS" \[-1000...1000] 0 "XV\_CONTRAST" \[-1000...1000] 0

# [RETURN VALUES](#RETURN_VALUES)

\[Success]

Returned if [**XvGetPortAttribute**(3)](/man/os/libxv/XvGetPortAttribute.3) completed successfully.

\[XvBadExtension]

Returned if the Xv extension is unavailable.

\[XvBadAlloc]

Returned if [**XvGetPortAttribute**(3)](/man/os/libxv/XvGetPortAttribute.3) failed to allocate memory to process the request.

# [DIAGNOSTICS](#DIAGNOSTICS)

\[XvBadPort]

Generated if the requested port does not exist.

\[BadMatch]

Generated if the requested attribute atom does not specify an attribute supported by the adaptor.

# [SEE ALSO](#SEE_ALSO)

[**XvSetPortAttribute**(3)](/man/os/libxv/XvSetPortAttribute.3), [**XvPortNotify**(3)](/man/os/libxv/XvPortNotify.3)

libXv 1.0.13 X Version 11

---

Document: XvGetPortAttribute(3) from libxv 1.0.13-r7 (Chainguard OS)
Source: https://gitlab.freedesktop.org/xorg/lib/libxv