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

Artículo
02/23/2024

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 para la memoria.

Valor devuelto

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

Comentarios

Dxgkrnl implementa DXGKCB_XXX funciones. Para usar esta función de devolución de llamada, establezca el miembro adecuado de DXGKARGCB_MAPMDLTOIOMMU y, a continuación, 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 provocar una seguridad comprometida de las páginas desde MDL. Las páginas podrían ser reasignadas por Mm por el momento en que no están asignadas.

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