summaryrefslogtreecommitdiff
path: root/man/XvQueryPortAttributes.man
blob: 9fbc50702aef81c52d4d2b93a70bf974e6c83d36 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
.TH XvQueryPortAttributes __libmansuffix__ __vendorversion__ "libXv Functions"
.SH NAME
XvQueryPortAttributes \- return list of attributes of a video port
.\"
.SH SYNOPSIS
.B #include <X11/extensions/Xvlib.h>
.sp
.nf
.BI "XvAttribute* XvQueryPortAttributes(Display *" dpy ","
.BI "                 XvPortID " port ",  int *" p_num_attributes ");"
.fi
.SH ARGUMENTS
.\"
.IP \fIdpy\fR 8
Specifies the connection to the X server.
.IP \fIport\fR 8
Specifies the port whose adaptor is to be queried for its list of attributes.
.IP \fIp_num_attributes\fR 8
A pointer to where the number of attributes returned in the array is written.
.\"
.SH DESCRIPTION
.BR XvQueryPortAttributes (__libmansuffix__) returns the number of attributes
and an array of XvAttributes valid for the given port.  The array may be
freed with
.BR XFree (__libmansuffix__).
.SH RETURN VALUES
XvAttribute has the following structure:
.EX

    typedef struct {
      int flags;
      int min_value;
      int max_value;
      char *name;
    } XvAttribute;

.EE
.IP \fIflags\fR 8
May be XvGettable or XvSettable or both OR'd together indicating the
particular attribute is readable, writeable or readable and writeable.
.IP \fImin_value\fR 8
The minimum attribute values which are valid for the driver.
.IP \fI max_value\fR 8
The maximum attribute values which are valid for the driver.
.IP \fIname\fR 8
A string describing the name of the attribute that may be used
to retrieve the Atom for the particular attribute.
.\"
.SH DIAGNOSTICS
.IP [XvBadPort] 8
Generated if the requested port does not exist.
.\"
.SH SEE ALSO
.BR XvGetPortAttribute (__libmansuffix__),
.BR XvSetPortAttribute (__libmansuffix__)