XvQueryAdaptors.man revision 9f606849 
 XvQueryAdaptors __libmansuffix__ __vendorversion__
 Name
XvQueryAdaptors - return adaptor information for a screen

 Syntax
 #include <X11/extensions/Xvlib.h> 
 "XvQueryAdaptors(Display *" dpy ", Window " window ",  " unsigned int *" p_num_adaptors ",  " XvAdaptorInfo **" pp_adaptor_info ");" 


 Arguments

 dpy 8
Specifies the connection to the X server.

 window 8
Specifies a window of the screen for which the adaptor 
information is desired.

 p_num_adaptors 8
A pointer to where the number of adaptors for the specified screen 
is returned.

 pp_adaptor_info 8
A pointer to where the list of returned adaptor information is
returned.

 Description

XvQueryAdaptors(__libmansuffix__) returns an video adaptor information for
the screen of the specified drawable. The XvAdaptorInfo structure
has the following organization:
.EX

 typedef struct {
 XvPortID base_id;
 unsigned long num_ports;
 char type;
 char *name;
 unsigned long num_formats;
 XvFormat *formats;
 unsigned long num_adaptors;
 } XvAdaptorInfo;



 base_id 8
The resource ID of the first adaptor port.

 num_ports 8
The number of ports supported by the adaptor.

 type 8
A bit mask with the value XvInputMask asserted if the adaptor supports video
input, and value XvOutputMask asserted if the adaptor supports video output.

 name 8
A vendor specific name that identifies the adaptor.

 num_formats 8
The number of depth/visual id formats supported by the adaptor.

 formats 8
A pointer to an array of XvFormat structures.


The XvFormat structure has the following organization:
.EX

 typedef struct {
 char depth;
 unsigned long visual_id;
 } XvFormat;



 depth 8
A drawable depth supported by the adaptor.

 visual_id 8
A visual-id supported for the given depth by the adaptor.

 Returned Values
 [Success] 8
Returned if XvQueryAdaptors(__libmansuffix__) completed successfully.

 [XvBadExtension] 8
Returned if the Xv extension is unavailable.

 [XvBadAlloc] 8
Returned if XvQueryAdaptors(__libmansuffix__) failed to allocate memory to process
the request.

 Diagnostics
 [Drawable] 8
Returned if the requested drawable does not exist.

 See Also
XvFreeAdaptorInfo(__libmansuffix__)