DVD サブpicture プロパティ セット

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

DVD サブ画像プロパティは、サブ画像ディスプレイの色、コントラスト、出力を制御します。

次の情報は、 IKsPropertySet メソッドの呼び出しでこのプロパティ セットに使用するために必要な定数とデータ型を示しています。 GUID (guidPropSet)、プロパティ ID (dwPropID)、およびプロパティ データ型 (pPropData) パラメーターの値を提供します。

Label	値
[プロパティ セット GUID]	AM_KSPROPSETID_DvdSubPic

プロパティ ID	説明
AM_PROPERTY_DVDSUBPIC_COMPOSIT_ON	サブ画像の表示を有効または無効にする設定専用プロパティ。 DirectShow は、このプロパティの AM_PROPERTY_COMPOSIT_ON ブール型と、このデータ型へのポインターとしてPAM_PROPERTY_COMPOSIT_ONを定義します。 TRUE は サブ画像を表示し、 FALSE は 無効にしたことを示します。 詳細については、Windows DDK の WDM 部分を参照してください。
AM_PROPERTY_DVDSUBPIC_HLI	色またはコントラストが変更されるサブ画像または画面の四角形を指定する設定専用プロパティ。 データ型が AM_PROPERTY_SPHLI。 「解説」を参照してください。
AM_PROPERTY_DVDSUBPIC_PALETTE	サブ画像のパレットを設定します。 データ型が AM_PROPERTY_SPPAL。

解説

AM_PROPERTY_DVDSUBPIC_HLI プロパティは設定のみ可能です。 色またはコントラストが変更されるサブ画像または画面の四角形を指定します。 これは、Microsoft DVD ナビゲーターがすべてのボタンとキーボード情報を解析し、特定の時点でサブ画像デコーダーに 1 つの強調表示四角形のみを渡すという点で、DVD-Video仕様とは異なります。 その結果、ハイライト情報は DVD ストリームに存在するよりもデコーダーに送信される頻度が高くなります。

強調表示情報は、データ ストリームに非同期的に到着します。 デコーダーでは、強調表示の [開始] タイム スタンプと [終了] タイム スタンプを使用して、強調表示情報を関連するサブ画像情報 (存在する場合) に関連付けます。 デコーダーが要求されたタイム スタンプのサブ画像ストリーム情報を受信していない場合、デコーダーは強調表示情報がスタンドアロンであり、サブピックには適用されないと見なします。 この場合、デコーダーは、色とコントラストの情報がすべて同じ色であると想定します。

データは完全に DVD ディスク形式ではありません。 Microsoft は、 パラメーターとしてこのプロパティ に 渡されるAM_PROPERTY_SPHLI型の追加の構造を提供します。 この構造では、DVD ハイライト情報から現在選択されているボタンについて説明します。

DVD ナビゲーターは、すべてのキーストローク情報を処理し、ボタンの状態が変更されるたびに新しい強調表示情報を送信します。 この情報では、一度に 1 つのボタンの 1 つのモードのみが記述されます。 画面のピクセル座標の表示四角形、またはサブ画像の表示 (存在する場合) が含まれます。 構造体には、色とコントラストの情報も含まれますが、現在選択されているボタンの現在の状態に対してのみ含まれます。 形式は DVD 仕様で定義されています。

強調表示情報には、開始時刻と終了のタイム スタンプが含まれています。 これらは他のタイム スタンプと同じ単位です。ただし、2 つの例外があります。0xFFFFFFFFの開始タイム スタンプは、受信時に highlight プロパティが有効であることを意味し、0xFFFFFFFF の終了タイム スタンプは、次の強調表示が受信されるまで強調表示プロパティが有効であることを意味します。

HLISS フィールドは、DVD 仕様で定義されているとおりです。 値 0 は、すべての強調表示が無効であることを示し、デコーダーはすべての強調表示を無効にする必要があります。

要件

要件	値
ヘッダー	Dvdmedia.h

関連項目

プロパティ セット