Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
XvQueryAdaptors(3)		 libXv Functions	      XvQueryAdaptors(3)

NAME
     XvQueryAdaptors - return adaptor information for a screen

SYNOPSIS
     #include <X11/extensions/Xvlib.h>

     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 adaptor 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 re-
	     turned.

DESCRIPTION
     XvQueryAdaptors(3)
      returns an video adaptor information for the screen of the specified draw-
     able.  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  sup-
	     ports  video  input, and value XvOutputMask asserted if the adaptor
	     supports video output.  In Xv protocol 2.2 and later, there  are  3
	     new  bits	defined - XvVideoMask, XvStillMask and XvImageMask indi-
	     cating that the adaptor is capable of video, still or image  primi-
	     tives 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(3) completed successfully.

     [XvBadExtension]
	     Returned if the Xv extension is unavailable.

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

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

SEE ALSO
     XvFreeAdaptorInfo(3)

X Version 11			  libXv 1.0.13		      XvQueryAdaptors(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XvQueryAdaptors&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help