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

FreeBSD Manual Pages

  
 
  

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 informa-
	       tion 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(3)
	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 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 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(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.12		    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+14.3.quarterly>

home | help