XvStopVideo(3X)

名前
XvStopVideo - アクティブなビデオを止める

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

XvStopVideo(dpy, port, draw)

Display *dpy;
XvPortID port;
Drawable draw;

引き数

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

port
    ポートを指定する。このポートのビデオが停止する。

draw
    指定されたポートに対応するドロウアブルを指定する。

説明
XvStopVideo(3X) は、指定されたポートとドロウアブルについてアクティブな ビデオを止める。このポートがビデオを処理していない場合や、別のドロウアブル でビデオを処理している場合には、リクエストは無視される。ビデオが停止し た時には、これに対応するドロウアブルに対し、詳細内容として XvStopped を持つ XvVideoNotify(3X) イベントが生成される。

返り値

[Success]
    XvStopVideo(3X) が正常終了した場合に返される。

[XvBadExtension]
    Xv 機能拡張が使用できない場合に返される。

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

診断

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

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

関連項目
XvGetVideo(3X), XvPutVideo(3X), XvVideoNotifyEvent(3X)