XvQueryAdaptors(3X)

名前
XvQueryAdaptors - スクリーンについてのアダプタ情報を返す

書式
#include <X11/extensions/Xvlib.h>

XvQueryAdaptors(dpy, win, p_num_adaptors, pp_adaptor_info)

Display *dpy;
Drawable draw;
int *p_num_adaptors;
XvAdaptorInfo **pp_adaptor_info;

引き数

dpy Xv サーバが Xv クライアントからのリクエストを受け付けるディスプレイ画面 を指定する。ディスプレイを指定するオプションが指定されていなければ、Xv は DISPLAY 環境変数で指定されているディスプレイを使う。ディスプレイ 指定オプションは「ホスト名:番号」という形式である。コロン 1 つ(:)でな く、コロン 2 つ(::)を使った場合には、トランスポート層で DECnet を使う ことが指定される。

draw
    アダプタ情報が要求されるスクリーンのドロウアブルを指定する。

p_num_adaptors
    指定されたスクリーンに対するアダプタの数へのポインタが返される。

pp_adaptor_info
    返されたアダプタ情報のリストへのポインタが返される。

説明
XvQueryAdaptors(3X) は、指定されたドロウアブルのスクリーンに対するビデ オアダプタの情報を返す。XvAdaptorInfo の内容は以下である:
         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
    最初のアダプタポートのリソース ID.

num_ports
    アダプタがサポートしているポート数。

type
    ビットマスク。アダプタがビデオ入力をサポートしていれば、XvInputMask の ビットが立ち、アダプタがビデオ出力をサポートしていれば、XvOutputMask のビットが立つ。

name
    アダプタを識別するベンダ固有の名称。

num_formats
    アダプタがサポートしている深さ/ビジュアル ID 形式の種類の数。

formats
    XvFormat 構造体の配列へのポインタ。

XvFormat 構造体の内容は以下である:
         typedef struct {
           char depth;
           unsigned long visual_id;
         } XvFormat;

depth
    アダプタがサポートしているドロウアブルの深さ。

visual_id
    アダプタが指定された深さにおいてサポートしているビジュアル ID.

返り値

[Success]
    XvQueryAdaptors(3X) が正常に終了すると返される。

[XvBadExtension]
    Xv 機能拡張が使用できない。

[XvBadAlloc]
    XvQueryAdaptors(3X) が、リクエストを処理するためのメモリの割り当てに失 敗した場合に返される。

診断

[Drawable]
    要求されたドロウアブルが存在しない場合に返される。

関連項目
XvFreeAdaptorInfo(3X)