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。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 10 （WDDM 2.0） |
| 標頭 | d3dkmddi.h |
| IRQL | <= APC_LEVEL |