IDvdControl2::SelectSubpictureStream メソッド (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
メソッドは SelectSubpictureStream
、表示するサブ画像ストリームを設定します。
構文
HRESULT SelectSubpictureStream(
ULONG ulSubPicture,
[in] DWORD dwFlags,
[out] IDvdCmd **ppCmd
);
パラメーター
ulSubPicture
サブ画像ストリームを指定する値。0 ~ 31、または 63 である必要があります。
値 | 説明 |
---|---|
0-31 | ストリームは有効です。 |
63 | ストリームは ダミー ストリームです。これは、ミュートされた低ビットレートのストリームであることを意味します。 |
[in] dwFlags
コマンドを同期する方法を指定する 、DVD_CMD_FLAGS 列挙からの 1 つ以上のフラグのビットごとの OR。
[out] ppCmd
DVD コマンドの同期に使用できる IDvdCmd オブジェクトへのポインターを受け取ります。 呼び出し元はインターフェイスを解放する必要があります。 このパラメーターは、NULL でもかまいません。 詳細については、「 DVD コマンドの同期」を参照してください。
戻り値
次のいずれかの値を返します。
リターン コード | 説明 |
---|---|
|
成功しました。 |
|
ulSubPicture が範囲外であるか、SP ストリームに対応していません。 |
|
ulSubPicture パラメーターは有効ですが、DVD ナビゲーターは何らかの理由で設定できません。 |
|
UOP 制御は操作を禁止します。 |
|
ドメインが無効です。 |
|
指定されたストリームが無効になっています。 |
解説
次の表は、このメソッド名が対応する Annex J コマンド名と、このメソッドが有効なドメインを示しています。
Annex J コマンド名 | 有効なドメイン |
サブpicture_Stream_Change |
|
要件
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | strmif.h (Dshow.h を含む) |
Library | Strmiids.lib |