Compartilhar via


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

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.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1803 (WDDM 2.4)
Cabeçalho d3dkmddi.h
IRQL PASSIVE_LEVEL

Confira também

DXGKARGCB_MAPMDLTOIOMMU

DXGKCB_UNMAPMDLFROMIOMMU

DXGKRNL_INTERFACE