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

Artigo
02/26/2024

A função DxgkDdiCloseAllocation desassocia alocações específicas do dispositivo que a função DxgkDdiOpenAllocation criou.

Sintaxe

DXGKDDI_CLOSEALLOCATION DxgkddiCloseallocation;

NTSTATUS DxgkddiCloseallocation(
  [in] IN_CONST_HANDLE hDevice,
  [in] IN_CONST_PDXGKARG_CLOSEALLOCATION pCloseAllocation
)
{...}

Parâmetros

[in] hDevice

Um identificador para o dispositivo de contexto gráfico do qual as alocações são desassociadas. A função DxgkDdiCreateDevice do driver de miniporta de vídeo forneceu anteriormente esse identificador para o subsistema kernel de elementos gráficos do Microsoft DirectX no membro hDevice da estrutura DXGKARG_CREATEDEVICE .

[in] pCloseAllocation

Um ponteiro para uma estrutura DXGKARG_CLOSEALLOCATION que contém informações sobre a desassociação de alocações.

Retornar valor

DxgkDdiCloseAllocation retorna STATUS_SUCCESS ou um resultado de erro apropriado se as alocações não forem desvinculadas com êxito do dispositivo de contexto gráfico.

Comentários

Antes que o driver de miniporto de exibição receba uma chamada para sua função DxgkDdiDestroyAllocation para liberar alocações, o driver chama a função DxgkDdiCloseAllocation para fechar todas as associações a essas alocações.

Para um recurso que contém várias alocações, o subsistema de kernel de elementos gráficos DirectX direciona DxgkDdiCloseAllocation para fechar simultaneamente todas as alocações especificando os identificadores para as alocações específicas do dispositivo no membro pOpenHandleList da estrutura DXGKARG_CLOSEALLOCATION .

DxgkDdiCloseAllocation deve ser tornado paginável.