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

# XvGetPortAttribute(3)

return current port attribute value

## NAME

XvGetPortAttribute - return current port attribute value

## SYNOPSIS

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

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

## ARGUMENTS

- *dpy*

  Specifies the connection to the X server.

- *port*

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

- *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*

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

## DESCRIPTION

[**XvGetPortAttribute**(3)](/XvGetPortAttribute/3.md) 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

- \[Success\]

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

- \[XvBadExtension\]

  Returned if the Xv extension is unavailable.

- \[XvBadAlloc\]

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

## 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

[**XvSetPortAttribute**(3)](/XvSetPortAttribute/3.md), [**XvPortNotify**(3)](/XvPortNotify/3.md)