DXGKCB_ACQUIREHANDLEDATA 콜백 함수(d3dkmddi.h)

아티클
02/06/2025

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 호출할 수 있습니다. 할당 삭제에는 할당 생성 중에 Dxgkrnl 반환된 할당 개체를 삭제하라는 KMD 요청이 포함되므로 KMD는 해제된 메모리에 대한 부실 포인터로 끝날 수 있습니다. DxgkcbAcquirehandledata 및 DxgkcbReleasehandledata 드라이버가 Dxgkrnl 개체에 대한 참조를 보유하고 Dxgkrnl 릴리스 호출이 수행될 때까지 할당 및 KMD 관련 개체를 삭제하지 않도록 할 수 있습니다.

DXGKCB_XXX 함수는 Dxgkrnl의해 구현됩니다. 이 콜백 함수를 사용하려면 DXGKARGCB_GETHANDLEDATA 멤버를 설정한 다음 DXGKRNL_INTERFACE통해 DxgkCbAcquireHandleData 호출합니다.