XvGetPortAttribute(3XUNIX Programmer's ManuXvGetPortAttribute(3X)
Name
XvGetPortAttribute - return current port attribute value
Syntax
#include <X11/extensions/Xvlib.h>
XvGetPortAttribute(dpy, port, attribute, p_value)
Display *dpy;
XvPortID port;
Atom attribute;
int *p_value;
Arguments
dpy Specifies the display screen on which the X Server
is to accept requests from X clients. If the
display option is not specified, X uses the display
screen specified by your DISPLAY environment vari-
able. The display option has the format
hostname:number. Using two colons (::) instead of
one (:) indicates that DECnet is to be used for
transport.
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 fol-
lowing table.
p_value Pointer to the location where the attribute value is
written on return.
Description
XvGetPortAttribute(3X) 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.
XFree86 Version 4.5.0 1
XvGetPortAttribute(3XUNIX Programmer's ManuXvGetPortAttribute(3X)
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(3X) completed suc-
cessfully.
[XvBadExtension]
Returned if the Xv extension is unavailable.
[XvBadAlloc]
Returned if XvGetPortAttribute(3X) failed to allo-
cate 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(3X), XvPortNotify(3X)
XFree86 Version 4.5.0 2