Name
XvGetPortAttribute - return current port attribute value
Syntax
#include
XvGetPortAttribute(Display *dpy, XvPortID port,
Atom attribute, int p_value);
Arguments
-
_d_p_y
Specifies the connection to the X server.
-
-
_p_o_r_t
Specifies the port, associated with the given display, for
-
which the attribute values are to be returned.
-
_a_t_t_r_i_b_u_t_e
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___v_a_l_u_e
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___v_a_l_u_e.
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
Returned 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)