書式

#include <X11/extensions/Xvlib.h>

XvSelectPortNotify(dpy, port, onoff)

Display *dpy;
XvPortID port;
Bool onoff;

引き数

dpy

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

port

ポートの属性が XvSetPortAttribute(3X) を使って変更された時に PortNotify イベントが生成されるポートを指定する。

onoff

通知を有効にするか無効にするかを指定する。

説明

XvSelectPortNotify(3X) は、リクエストを出しているクライアントへの PortNotify イベントの通知を有効または無効にする。ポートの属性が XvSetPortAttribute(3X) を使って変更された時には、XvPortNotify(3X) イベントが生成される。

返り値

[Success]

XvSelectPortNotify(3X) が正常終了した時に返される。

[XvBadExtension]

Xv 機能拡張が使えない場合に返される。

[XvBadAlloc]

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

診断

[XvBadPort]

要求されたポートが存在しない場合に生成される。