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)
対象プラットフォーム デスクトップ
Header d3dkmddi.h (D3dkmddi.h を含む)
IRQL < DISPATCH_LEVEL

こちらもご覧ください

DXGKRNL_INTERFACE