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

Artigo
02/26/2024

DXGKCB_ALLOCATEPAGESFORMDL aloca páginas de memória física para que uma MDL (lista de descritores de memória) seja mapeada para o espaço de endereço lógico da IOMMU.

Sintaxe

DXGKCB_ALLOCATEPAGESFORMDL DxgkcbAllocatepagesformdl;

NTSTATUS DxgkcbAllocatepagesformdl(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARGCB_ALLOCATEPAGESFORMDL pAllocatePagesForMdl
)
{...}

Parâmetros

[in] hAdapter

Um identificador para o adaptador de exibição.

[in/out] pAllocatePagesForMdl

Ponteiro para uma estrutura DXGKARGCB_ALLOCATEPAGESFORMDL que contém argumentos para alocar páginas para MDL.

Retornar valor

Retornar STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, retorne um código de erro NTSTATUS apropriado.

Comentários

Essa função de retorno de chamada é uma função de driver de porta gráfica do Windows equivalente à função MmAllocatePagesForMdl.

DXGKCB_XXX funções são implementadas por Dxgkrnl. Para usar essa função de retorno de chamada, defina os membros apropriados do DXGKARGCB_ALLOCATEPAGESFORMDL e, em seguida, chame DxgkCbAllocatePagesForMdl por meio do DXGKRNL_INTERFACE.

Toda a memória acessada pela GPU durante operações de paginação ou mapeada por meio do GpuMmu deve ser mapeada para a IOMMU. O Dxgkrnl fornece retornos de chamada para o driver do modo kernel para permitir a alocação e o remapeamento em uma etapa.

Observação

As chamadas para DXGKCB_ALLOCATEPAGESFORMDL são limitadas à restrição MDL de 4 GB PAGE_SIZE e Dxgkrnl sempre especifica o sinalizador MM_ALLOCATE_FULLY_REQUIRED na chamada interna para a função MmAllocatePagesForMdlEx. O driver também não deve bloquear nenhuma memória. O Dxgkrnl gerenciará páginas bloqueadas para o driver e, depois que a memória for remapeada, o endereço lógico das páginas fornecidas ao driver poderá não corresponder mais aos endereços físicos.

Consulte Isolamento de GPU baseado em IOMMU para obter mais informações.