DXGKCB_MAPMDLTOIOMMU función de devolución de llamada (d3dkmddi.h)

2025-02-06

Un controlador de miniporte de pantalla en modo kernel llama a DXGKCB_MAPMDLTOIOMMU para asignar una lista de descriptores de memoria (MDL) a la IOMMU para que la GPU pueda acceder a la memoria subyacente.

Sintaxis

DXGKCB_MAPMDLTOIOMMU DxgkcbMapmdltoiommu;

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

Parámetros

[in] hAdapter

Identificador de un adaptador de pantalla. El controlador proporciona este identificador para el dispositivo maestro/cliente potencial en la cadena LDA.

[in/out] pMapMdlToIoMmu

Puntero a una estructura de DXGKARGCB_MAPMDLTOIOMMU que contiene un identificador de la memoria.

Valor devuelto

Devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, devuelve un código de error NTSTATUS Values adecuado.

Observaciones

DXGKCB_XXX funciones se implementan mediante Dxgkrnl. Para usar esta función de devolución de llamada, establezca el miembro adecuado de DXGKARGCB_MAPMDLTOIOMMU y llame a DxgkCbMapMdlToIoMmu a través del DXGKRNL_INTERFACE.

Si el controlador usa esta devolución de llamada, es responsable de garantizar que la duración de MDL supere la llamada de DXGKCB_UNMAPMDLFROMIOMMU correspondiente. De lo contrario, la llamada DXGKCB_UNMAPMDLFROMIOMMU tiene un comportamiento indefinido y puede dar lugar a una seguridad comprometida de las páginas de MDL. Las páginas podrían reasignarse por Mm en el momento en que no están asignadas.

Consulte de aislamiento de GPU basado en IOMMU para obtener más información.