| XvGetPortAttribute(3) | Library Functions Manual | XvGetPortAttribute(3) | 
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) 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.
 
 
 
| "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
 XvSetPortAttribute(3), XvPortNotify(3)