IDisplayDeviceInterop::OpenSharedHandle メソッド (windows.devices.display.core.interop.h)
共有プライマリ サーフェス、共有フェンス、およびソース プレゼンテーション ハンドルのハンドルを開きます。
構文
HRESULT OpenSharedHandle(
HANDLE NTHandle,
IID riid,
void **ppvObj
);
パラメーター
NTHandle
型: HANDLE
共有プライマリ サーフェス、共有フェンス、またはソース プレゼンテーション ハンドルの NT ハンドル。
riid
型: REFIID
次のいずれかのWindows ランタイム クラスの既定のインターフェイスのインターフェイス識別子 (IID) への参照。 IID は GUID です。
ppvObj
型: void**
riid 引数で指定されたインターフェイスへのポインターを受け取るメモリ ブロックへのポインター。
戻り値
型: HRESULT
成功 したS_OK 、または失敗時の問題を説明するエラー コードを返します。
注釈
このメソッドを使用して共有フェンスを開くことができますが、サーフェスを開くことができるのはプライマリとして作成された場合のみです。 プライマリ サーフェスは、ディスプレイ ハードウェアがスキャンアウトするために直接使用することを目的としたサーフェスです。ほとんどの一般的な Direct3D サーフェスは、スワップ チェーン バック バッファーで使用するために作成されていない限り、プライマリとして作成されません。 DisplayDevice.CreatePrimary は常にプライマリとしてサーフェスを作成します。これは、常にスキャンアウトに使用されることを意図しているためです。
ソース プレゼンテーション ハンドルを開くのは、プレゼンテーション ハンドルのターゲットに対して CreateScanoutSource を呼び出すのと似ていますが、ハンドルを作成したのと同じ DisplayManager から DisplayDevice を作成する必要はありません。 これにより、スキャンアウトのきめ細かいアクセス制御が可能になります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10 ビルド 20348 |
| サポートされている最小のサーバー | Windows 10 ビルド 20348 |
| 対象プラットフォーム | Windows |
| ヘッダー | windows.devices.display.core.interop.h |
| Library | d3d12.lib |
| [DLL] | d3d12.dll |