Name

XvQueryAdaptors - return adaptor information for a screen

Syntax

#include


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

Arguments

_d_p_y Specifies the connection to the X server.
_w_i_n_d_o_w Specifies a window of the screen for which the adaptor
information is desired.
_p___n_u_m___a_d_a_p_t_o_r_s A pointer to where the number of adaptors for the specified screen
is returned.
_p_p___a_d_a_p_t_o_r___i_n_f_o 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;

_b_a_s_e___i_d The resource ID of the first adaptor port.
_n_u_m___p_o_r_t_s The number of ports supported by the adaptor.
_t_y_p_e A bit mask with the value XvInputMask asserted if the adaptor supports video
input, and value XvOutputMask asserted if the adaptor supports video output.
_n_a_m_e A vendor specific name that identifies the adaptor.
_n_u_m___f_o_r_m_a_t_s The number of depth/visual id formats supported by the adaptor.
_f_o_r_m_a_t_s A pointer to an array of XvFormat structures.

The XvFormat structure has the following organization:

        

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

_d_e_p_t_h A drawable depth supported by the adaptor.
_v_i_s_u_a_l___i_d A visual-id supported for the given depth by the adaptor.

Returned 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)