1XvQueryAdaptors(3)              libXv Functions             XvQueryAdaptors(3)
2
3
4

NAME

6       XvQueryAdaptors - return adaptor information for a screen
7

SYNOPSIS

9       #include <X11/extensions/Xvlib.h>
10
11       int XvQueryAdaptors(Display *dpy, Window window,
12                           unsigned int *p_num_adaptors,
13                           XvAdaptorInfo **pp_adaptor_info);
14

ARGUMENTS

16       dpy     Specifies the connection to the X server.
17
18       window  Specifies a window of the screen for which the adaptor informa‐
19               tion is desired.
20
21       p_num_adaptors
22               A pointer to where the number of  adaptors  for  the  specified
23               screen is returned.
24
25       pp_adaptor_info
26               A  pointer to where the list of returned adaptor information is
27               returned.
28

DESCRIPTION

30       XvQueryAdaptors(3)
31        returns an video adaptor information for the screen of  the  specified
32       drawable.  The XvAdaptorInfo structure has the following organization:
33
34            typedef struct {
35              XvPortID base_id;
36              unsigned long num_ports;
37              char type;
38              char *name;
39              unsigned long num_formats;
40              XvFormat *formats;
41              unsigned long num_adaptors;
42            } XvAdaptorInfo;
43
44
45       base_id The resource ID of the first adaptor port.
46
47       num_ports
48               The number of ports supported by the adaptor.
49
50       type    A  bit  mask with the value XvInputMask asserted if the adaptor
51               supports video input, and value XvOutputMask  asserted  if  the
52               adaptor  supports  video output.  In Xv protocol 2.2 and later,
53               there are 3 new bits defined  -  XvVideoMask,  XvStillMask  and
54               XvImageMask  indicating  that  the adaptor is capable of video,
55               still or image primitives respectively.
56
57       name    A vendor specific name that identifies the adaptor.
58
59       num_formats
60               The number of depth/visual id formats supported by the adaptor.
61
62       formats A pointer to an array of XvFormat structures.
63
64       The XvFormat structure has the following organization:
65
66            typedef struct {
67              char depth;
68              unsigned long visual_id;
69            } XvFormat;
70
71
72       depth   A drawable depth supported by the adaptor.
73
74       visual_id
75               A visual-id supported for the given depth by the adaptor.
76

RETURN VALUES

78       [Success]
79               Returned if XvQueryAdaptors(3) completed successfully.
80
81       [XvBadExtension]
82               Returned if the Xv extension is unavailable.
83
84       [XvBadAlloc]
85               Returned if XvQueryAdaptors(3) failed  to  allocate  memory  to
86               process the request.
87

DIAGNOSTICS

89       [Drawable]
90               Returned if the requested drawable does not exist.
91

SEE ALSO

93       XvFreeAdaptorInfo(3)
94
95
96
97X Version 11                     libXv 1.0.11               XvQueryAdaptors(3)
Impressum