DXGKCB_ACQUIREHANDLEDATA コールバック関数 (d3dkmddi.h)

[アーティクル]
02/23/2024

DXGKCB_ACQUIREHANDLEDATA は、割り当てへの参照を取得します。

構文

DXGKCB_ACQUIREHANDLEDATA DxgkcbAcquirehandledata;

VOID * DxgkcbAcquirehandledata(
  [in]  IN_CONST_PDXGKARGCB_GETHANDLEDATA unnamedParam1,
  [out] PDXGKARG_RELEASE_HANDLE unnamedParam2
)
{...}

パラメーター

[in] unnamedParam1

DXGKCB_CREATECONTEXTALLOCATIONによって返される割り当てハンドルを記述するDXGKARGCB_GETHANDLEDATA構造体へのポインター。

[out] unnamedParam2

割り当て参照を解放するときに使用するドライバーのリリースハンドルへのポインター。

戻り値

[なし] :

解説

割り当てハンドルは、アプリケーションまたは有効なハンドルの D3DKMTDestroyAllocation へのユーザーモードドライバー呼び出しによって、いつでも破棄できます。割り当ての破棄には、割り当ての作成時に Dxgkrnl が返した割り当てオブジェクトを削除するカーネルモードドライバーへの要求が含まれるため、KMD は解放されたメモリへの古いポインターで終わる可能性があります。 DXGKCB_ACQUIREHANDLEDATA と DXGKCB_RELEASEHANDLEDATA 、ドライバーが Dxgkrnl オブジェクトの参照を保持し、リリース呼び出しが行われるまで 、Dxgkrnl が割り当てと KMD に関連付けられたオブジェクトを破棄しないようにすることができます。

DXGKCB_XXX 関数は Dxgkrnl によって実装されます。このコールバック関数を使用するには、DXGKARGCB_GETHANDLEDATAのメンバーを設定し、DXGKRNL_INTERFACEを介して DxgkCbAcquireHandleData を呼び出します。