Manual Pages for UNIX Operating System command usage for man XvQueryAdaptors

libXv Functions                              XvQueryAdaptors(3xv)



NAME
     XvQueryAdaptors - return adaptor information for a screen

SYNOPSIS
     cc [ flag... ] file... -lXv [ library... ]
     #include 

     int XvQueryAdaptors(Display *dpy, Window window,
                         unsigned int *p_num_adaptors,
                         XvAdaptorInfo **pp_adaptor_info);

ARGUMENTS
     dpy     Specifies the connection to the X server.

     window  Specifies a window of the screen for which the adap-
             tor information is desired.

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

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

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

          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 The resource ID of the first adaptor port.

     num_ports
             The number of ports supported by the adaptor.

     type    A bit mask with the value  XvInputMask  asserted  if
             the  adaptor  supports video input, and value XvOut-
             putMask asserted if the adaptor supports video  out-
             put.   In Xv protocol 2.2 and later, there are 3 new
             bits  defined   -   XvVideoMask,   XvStillMask   and



X Version 11        Last change: libXv 1.0.5                    1






libXv Functions                              XvQueryAdaptors(3xv)



             XvImageMask  indicating  that the adaptor is capable
             of video, still or image primitives respectively.

     name    A vendor specific name that identifies the adaptor.

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

     formats A pointer to an array of XvFormat structures.

     The XvFormat structure has the following organization:

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


     depth   A drawable depth supported by the adaptor.

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

RETURN VALUES
     [Success]
             Returned if XvQueryAdaptors(3xv) completed  success-
             fully.

     [XvBadExtension]
             Returned if the Xv extension is unavailable.

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

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

SEE ALSO
     XvFreeAdaptorInfo(3xv)


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:







X Version 11        Last change: libXv 1.0.5                    2






libXv Functions                              XvQueryAdaptors(3xv)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | x11/library/libxv           |
    |_____________________________|_____________________________|
    | Interface Stability         | Volatile                    |
    |_____________________________|_____________________________|
    | MT-Level                    | See XInitThreads(3X11)      |
    |_____________________________|_____________________________|














































X Version 11        Last change: libXv 1.0.5                    3