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

Artigo
02/26/2024

A função DxgkDdiDestroyAllocation libera alocações.

Sintaxe

DXGKDDI_DESTROYALLOCATION DxgkddiDestroyallocation;

NTSTATUS DxgkddiDestroyallocation(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_DESTROYALLOCATION pDestroyAllocation
)
{...}

Parâmetros

[in] hAdapter

Um identificador para um bloco de contexto associado a um adaptador de exibição. O driver de miniporta de exibição anteriormente forneceu esse identificador para o subsistema kernel de elementos gráficos do Microsoft DirectX no parâmetro de saída MiniportDeviceContext da função DxgkDdiAddDevice .

[in] pDestroyAllocation

Um ponteiro para uma estrutura DXGKARG_DESTROYALLOCATION que contém informações para liberar alocações.

Retornar valor

DxgkDdiDestroyAllocation retorna STATUS_SUCCESS ou um resultado de erro apropriado se as alocações não forem liberadas com êxito.

Comentários

Quando o driver de exibição do modo de usuário chama a função pfnDeallocateCb , o subsistema de kernel de elementos gráficos DirectX (que faz parte do Dxgkrnl.sys) chama a função DxgkDdiDestroyAllocation do driver de miniport de exibição para liberar as alocações. O driver de miniporta de exibição deve limpo suas estruturas de dados internas e referências às alocações. O runtime do Microsoft Direct3D inicia chamadas para o gerenciador de memória de vídeo (que também faz parte do Dxgkrnl.sys), que chama o agendador de GPU (que também faz parte do Dxgkrnl.sys) para sincronizar antes que a memória do vídeo seja realmente liberada.

O driver de miniporta de exibição pode liberar todo o recurso, bem como alocações. Para determinar se o recurso deve ser liberado, o driver de miniporto de exibição pode marcar se o sinalizador DestroyResource está definido no membro Flags da estrutura DXGKARG_DESTROYALLOCATION para a qual o parâmetro pDestroyAllocation aponta. Para liberar o recurso, o driver de miniporto de exibição deve limpo o identificador especificado pelo membro hResource do DXGKARG_DESTROYALLOCATION. Se o driver do miniporto de exibição não liberar o recurso, o driver poderá alterar o valor em hResource , se necessário.

DxgkDdiDestroyAllocation deve ser tornado paginável.