XvGetPortAttribute - Man Page
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) 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) completed successfully.
- [XvBadExtension]
Returned if the Xv extension is unavailable.
- [XvBadAlloc]
Returned if XvGetPortAttribute(3) 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
Referenced By
Xv(3), XvPortNotify(3), XvQueryPortAttributes(3), XvSetPortAttribute(3).