IDvdControl2::SelectVideoModePreference メソッド (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
メソッドは SelectVideoModePreference 、指定されたビデオ モードの表示 (ワイド 画面、レターボックス、またはパン スキャン) を再生用に設定します。
構文
HRESULT SelectVideoModePreference(
[in] ULONG ulPreferredDisplayMode
);
パラメーター
[in] ulPreferredDisplayMode
DVD コンテンツの新しい表示モードを指定する値。 DVD_PREFERRED_DISPLAY_MODE列挙体のメンバー。
戻り値
次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
|
正常終了しました。 |
|
引数が無効です。 |
|
ドメインが無効です。 |
|
UOP 制御は操作を禁止します。 |
注釈
このメソッドは、既定のビデオ ウィンドウの縦横比を変更し、既定の縦横比変換メカニズムを指定することもできます。
アナモーフィック 16 x 9 ソース ビデオの場合は、720 x 480 ソース ビデオを 16 x 9 アスペクト比に引き伸ばして形成されます。
ワイド スクリーン 16 x 9 ソース ビデオを配置し、クライアント出力ウィンドウの最大 16 x 9 領域に拡大する必要があります。 ハイライトは、16 x 9 領域の内側に対して相対的です。 16 x 9 の領域を維持するには、上/下または辺に黒いバーを追加する必要があります。
パン スキャン 表示されるビデオは、ストレッチされた 16 x 9 ビデオから 4 x 3 サブウィンドウを取得することによって計算されます (水平オフセットは MPEG-2 ビデオのウィンドウのオフセットで提供されます)。 4 x 3 サブウィンドウは、出力クライアント ウィンドウの最大 4 x 3 領域に配置されます。 ハイライトの座標は、4 x 3 の出力ウィンドウに対して相対的です (ソース 16 x 9 ビデオとの関係はありません)。 4 x 3 の領域を維持するには、上/下または側面に黒いバーを追加する必要があります。
レター 出力クライアント ウィンドウの最大 4 x 3 領域を取得することで、4 x 3 の表示領域が形成されます。 4 x 3 の領域を維持するには、上/下または側面に黒いバーを追加する必要があります。 ソース 16 x 9 ビデオは、4 x 3 サブウィンドウ内の最大 16 x 9 サブウィンドウに配置されます。 16 x 9 の領域を維持するには、サブウィンドウの上部と下部に黒いバーを追加する必要があります。 ハイライトの座標は、4 x 3 サブウィンドウに対して相対的です (ソース 16 x 9 ビデオとは関係がありません)。 技術的には、ディスクが 16 x 9 領域の外側にあるハイライトを指定することは可能です (ただし、4 x 3 ウィンドウに残ります)。
4 x 3 ビデオの場合、ビデオは出力クライアント ウィンドウの最大 4 x 3 出力領域に配置されます。 4 x 3 の領域を維持するには、上/下または側面に黒いバーを追加する必要があります。
次の表は、このメソッド名が対応する Annex J コマンド名と、このメソッドが有効なドメインを示しています。
| Annex J コマンド名 | 有効なドメイン |
| Video_Presentation_Mode_Change |
|
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | strmif.h (Dshow.h を含む) |
| Library | Strmiids.lib |