DXGKCB_ACQUIREHANDLEDATA função de retorno de chamada (d3dkmddi.h)

Artigo
02/23/2024

DXGKCB_ACQUIREHANDLEDATA adquire uma referência a uma alocação.

Sintaxe

DXGKCB_ACQUIREHANDLEDATA DxgkcbAcquirehandledata;

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

Parâmetros

[in] unnamedParam1

Ponteiro para uma estrutura DXGKARGCB_GETHANDLEDATA que descreve um identificador de alocação retornado por DXGKCB_CREATECONTEXTALLOCATION.

[out] unnamedParam2

Ponteiro para um identificador de versão para o driver usar ao liberar a referência de alocação.

Valor retornado

Nenhum.

Comentários

Os identificadores de alocação podem ser destruídos a qualquer momento por um aplicativo ou por uma chamada de driver de modo de usuário para D3DKMTDestroyAllocation em um identificador válido. A destruição da alocação envolve uma solicitação ao driver do modo kernel para excluir o objeto de alocação que Dxgkrnl retornou a eles durante a criação da alocação, para que o KMD possa acabar com um ponteiro obsoleto para liberar memória. DXGKCB_ACQUIREHANDLEDATA e DXGKCB_RELEASEHANDLEDATA permitem que o driver mantenha uma referência no objeto Dxgkrnl e garanta que Dxgkrnl não destrua a alocação e os objetos associados ao KMD até que a chamada de versão seja feita.

DXGKCB_XXX funções são implementadas por Dxgkrnl. Para usar essa função de retorno de chamada, defina os membros do DXGKARGCB_GETHANDLEDATA e chame DxgkCbAcquireHandleData por meio do DXGKRNL_INTERFACE.