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)