DXGKCB_ACQUIREHANDLEDATA回呼函式 （d3dkmddi.h）

DxgkcbAcquirehandledata 會取得配置的參考。

語法

DXGKCB_ACQUIREHANDLEDATA DxgkcbAcquirehandledata;

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

參數

[in] unnamedParam1

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

[out] unnamedParam2

核心模式驅動程式 （KMD） 發行句柄的指標，以管理所取得配置之參考的存留期。 KMD 會在呼叫 DxgkcbReleasehandledata 來釋放配置參考時使用此句柄。

傳回值

DxgkcbAcquirehandledata 會傳回 KMD 要求參考的配置句柄。 KMD 會針對配置或資源的後續作業使用此句柄。

言論

應用程式或使用者模式驅動程式可以隨時呼叫 D3DKMTDestroyAllocation，以終結配置句柄。 配置解構牽涉到 KMD 的要求，以刪除配置物件，Dxgkrnl 在配置建立期間傳回給它們，因此 KMD 最終可能會有過時的記憶體指標。 DxgkcbAcquirehandledata 和 DxgkcbReleasehandledata 可讓驅動程式在 Dxgkrnl 物件上保留參考，並確保 Dxgkrnl 在發出發行呼叫之後，才會終結配置和 KMD 相關聯的物件。

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

要求

另請參閱

DXGKARGCB_GETHANDLEDATA

DxgkcbCreatecontextallocation

DxgkcbReleasehandledata

DXGKRNL_INTERFACE