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

Artigo
02/06/2025

Um driver de miniporto de exibição no modo kernel chama DXGKCB_MAPMDLTOIOMMU para mapear uma MDL (lista de descritores de memória) para a IOMMU para que a memória subjacente possa ser acessada pela GPU.

Sintaxe

DXGKCB_MAPMDLTOIOMMU DxgkcbMapmdltoiommu;

NTSTATUS DxgkcbMapmdltoiommu(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARGCB_MAPMDLTOIOMMU pMapMdlToIoMmu
)
{...}

Parâmetros

[in] hAdapter

Um identificador para um adaptador de exibição. O driver fornece esse identificador para o dispositivo mestre/líder na cadeia LDA.

[in/out] pMapMdlToIoMmu

Ponteiro para uma estrutura DXGKARGCB_MAPMDLTOIOMMU que contém um identificador para a memória.

Valor de retorno

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

Observações

DXGKCB_XXX funções são implementadas por Dxgkrnl. Para usar essa função de retorno de chamada, defina o membro apropriado do DXGKARGCB_MAPMDLTOIOMMU e chame DxgkCbMapMdlToIoMmu por meio do DXGKRNL_INTERFACE.

Se o driver usar esse retorno de chamada, ele será responsável por garantir que o tempo de vida do MDL exceda a chamada DXGKCB_UNMAPMDLFROMIOMMU correspondente. Caso contrário, a chamada DXGKCB_UNMAPMDLFROMIOMMU tem um comportamento indefinido e pode levar à segurança comprometida das páginas do MDL. As páginas podem ser reaproveitadas por Mm quando não forem mapeadas.

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