OPMGetVideoOutputsFromHMONITOR 関数 (opmapi.h)

特定の HMONITOR ハンドルに関連付けられている物理モニターごとに、Output Protection Manager (OPM) オブジェクトを作成します。

構文

HRESULT OPMGetVideoOutputsFromHMONITOR(
  [in]  HMONITOR                   hMonitor,
  [in]  OPM_VIDEO_OUTPUT_SEMANTICS vos,
  [out] ULONG                      *pulNumVideoOutputs,
  [out] IOPMVideoOutput            ***pppOPMVideoOutputArray
);

パラメーター

[in] hMonitor

OPM オブジェクトを作成するモニター ハンドル。 HMONITOR 値を返す関数がいくつかあります。 詳細については、Windows グラフィックス デバイス インターフェイス (GDI) のドキュメントの 「複数のディスプレイ モニター関数 」を参照してください。

[in] vos

OPM_VIDEO_OUTPUT_SEMANTICS列挙体のメンバー。

値	説明
OPM_VOS_OPM_SEMANTICS	返された IOPMVideoOutput ポインターでは、OPM セマンティクスが使用されます。
OPM_VOS_COPP_SEMANTICS	返される IOPMVideoOutput ポインターでは、Certified Output Protection Protocol (COPP) セマンティクスが使用されます。

[out] pulNumVideoOutputs

pppOPMVideoOutputArray パラメーターで返される IOPMVideoOutput ポインターの数を受け取ります。

[out] pppOPMVideoOutputArray

IOPMVideoOutput ポインターの配列へのポインターを受け取ります。 各 IOPMVideoOutput ポインターは、1 つの物理モニターに関連付けられます。 呼び出し元は、配列内の各ポインターを解放し、 CoTaskMemFree を呼び出して配列を解放する必要があります。

戻り値

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

解説

1 つの HMONITOR ハンドルを複数の物理モニターに関連付けることができます。 各物理モニターには、独自のコネクタがあります。 アプリケーションは、pppOPMVideoOutputArray で返される IOPMVideoOutput ポインターを使用して、物理モニターごとに保護メカニズムを個別に設定する必要があります。

IOPMVideoOutput インターフェイスには、vos パラメーターの値に応じて 2 つの動作モードがあります。 vos がOPM_VOS_COPP_SEMANTICS場合、IOPMVideoOutput は COPP セマンティクスを使用します。 このモードは、COPP との下位互換性を目的としています。 vos がOPM_VOS_OPM_SEMANTICS場合、IOPMVideoOutput では新しい OPM セマンティクスが使用されます。 動作の違いは、各メソッドの参照ページに記載されています。 モードは、オブジェクトの有効期間中は変更されません。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	opmapi.h
Library	Dxva2.lib
[DLL]	Dxva2.dll

関連項目

OPM 関数