DXGKCB_ACQUIREHANDLEDATA 콜백 함수(d3dkmddi.h)

아티클
08/07/2023

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를 호출합니다.