DXGKCB_GETHANDLEPARENT コールバック関数 (d3dkmddi.h)
DXGKCB_GETHANDLEPARENT 指定した割り当てから親リソースを取得します。
構文
DXGKCB_GETHANDLEPARENT DxgkcbGethandleparent;
D3DKMT_HANDLE DxgkcbGethandleparent(
[in] IN_D3DKMT_HANDLE hAllocation
)
{...}
パラメーター
[in] hAllocation
割り当てのハンドル。 このハンドルは、DirectX グラフィックス カーネル サブシステム (Dxgkrnl.sys) が割り当てに割り当てたカーネル モード ハンドルである必要があります。
戻り値
DXGKCB_GETHANDLEPARENT は、hAllocation パラメーターが指定するハンドルに関連付けられている割り当ての親リソースにグラフィックス サブシステム固有のハンドルを返します。
DXGKCB_GETHANDLEPARENT が NULL ハンドルを返した場合、次のような理由で、Dxgkrnl.sys は親リソースにハンドルを解決できませんでした。
- 悪意のある攻撃またはその他のバグが原因で、無効なハンドルがユーザー モード ディスプレイ ドライバーから受信されました。
- 割り当てには有効期間の問題がありました。
NULL ハンドルが返された場合、ディスプレイ ミニポート ドライバーは、STATUS_INVALID_HANDLEで現在実行中の DDI 関数に失敗する必要があります。
備考
リソース ハンドルを返 DXGKCB_GETHANDLEPARENT、hAllocation のハンドルは、リソースに関連付けられている割り当てハンドルである必要があります。それ以外の場合、DXGKCB_GETHANDLEPARENT は NULL を返します。
DXGKCB_XXX 関数は、Dxgkrnlによって実装されます。 このコールバック関数を使用するには、DXGKRNL_INTERFACE経由で DxgkCbGetHandleParent を呼び出します。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows Vista (WDDM 1.0) |
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | d3dkmddi.h (D3dkmddi.h を含む) |
IRQL | < DISPATCH_LEVEL |