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.
|
|
|
|
| 4p |
|
|
| Attribute String |
Type |
Default |
| 6p |
|
|
|
| 6p |
|
|
| "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 |
| 6p |
|
|
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)
