次の方法で共有

IDvdControl2::SetSubpictureState

  • [アーティクル]

SetSubpictureState メソッドは、サブピクチャの表示のオン/オフを切り替える。

構文

  HRESULT SetSubpictureState(
  BOOL bState,
  DWORD dwFlags,
  IDvdCmd **ppCmd
);

パラメータ

bState

[in] サブピクチャの表示をオンにするかどうかを指定するブール型の値。TRUE を指定すると、それ以降の再生でサブピクチャが表示される。

dwFlags

[in] コマンド同期オプションを指定する 1 つ以上の DVD_CMD_FLAGS 列挙を含むビット フラグ。

ppCmd

[out] DVD コマンドの同期に使える IDvdCmd オブジェクトへのポインタのアドレス。

戻り値

次のいずれかの値を返す。

戻りコード 説明
S_OK 成功。
VFW_E_DVD_INVALIDDOMAIN DVD ナビゲータが First Play ドメイン内にある。
VFW_E_DVD_OPERATION_INHIBITED UOP コントロールが処理を禁止している。

注意

通常、サブピクチャ ストリームは、メニューではボタン テキストや場合によってはボタンのグラフィックに、ビデオの再生では字幕、クレジット、その他のオーバーレイ グラフィックに使われる。サブピクチャをクローズド キャプションと混同してはならない。クローズド キャプションは、ビデオ ストリームの内部にエンコードされている。一般的に、このメソッドは、DVD ナビゲータ フィルタが DVD タイトル ドメイン内でビデオを再生している間にビデオに重ねて表示されるサブピクチャを制御することを目的としている。

このメソッドは、Annex J "Sub-picture_Stream_Change" コマンドの第 2 引数に相当する。

次の表は、このメソッド名が対応する Annex J コマンド名、このメソッドが有効なドメインを示している。

Annex J コマンド名 有効なドメイン
Sub-picture_stream_Change DVD_DOMAIN_VideoManagerMenu
DVD_DOMAIN_VideoTitleSetMenu
DVD_DOMAIN_Title
DVD_DOMAIN_Stop

参照