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

Artigo
02/23/2024

Um driver de miniporta 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 master/cliente potencial na cadeia LDA.

[in/out] pMapMdlToIoMmu

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

Retornar valor

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

Comentários

DXGKCB_XXX funções são implementadas por Dxgkrnl. Para usar essa função de retorno de chamada, defina o membro apropriado de DXGKARGCB_MAPMDLTOIOMMU e, em seguida, 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 Isolamento de GPU baseado em IOMMU para obter mais informações.