DXGKCB_ACQUIREHANDLEDATA回呼函式 (d3dkmddi.h)

發行項
02/25/2024

DXGKCB_ACQUIREHANDLEDATA 會取得配置的參考。

語法

DXGKCB_ACQUIREHANDLEDATA DxgkcbAcquirehandledata;

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

參數

[in] unnamedParam1

DXGKARGCB_GETHANDLEDATA 結構的指標，描述DXGKCB_CREATECONTEXTALLOCATION所傳回的配置句柄。

[out] unnamedParam2

釋放配置參考時，要用於驅動程式之發行句柄的指標。

傳回值

無。

備註

配置句柄可以隨時由應用程式或使用者模式驅動程式呼叫有效句柄上的 D3DKMTDestroyAllocation 來 終結。配置解構牽涉到內核模式驅動程式的要求，以刪除 Dxgkrnl 在配置建立期間傳回給它們的配置物件，因此 KMD 最後可能會有已釋放記憶體的過時指標。 DXGKCB_ACQUIREHANDLEDATA和DXGKCB_RELEASEHANDLEDATA允許驅動程式保存 Dxgkrnl 對象的參考，並確保 Dxgkrnl 不會終結配置和 KMD 相關聯的物件，直到發出發行呼叫之後。

DXGKCB_XXX 函式是由 Dxgkrnl 實作。若要使用此回呼函式，請設定DXGKARGCB_GETHANDLEDATA的成員，然後透過 DXGKRNL_INTERFACE呼叫 DxgkCbAcquireHandleData。