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

Artículo
02/23/2024

DXGKCB_ALLOCATEPAGESFORMDL asigna páginas de memoria física para una lista de descriptores de memoria (MDL) que se asignará al espacio de direcciones lógicos de IOMMU.

Sintaxis

DXGKCB_ALLOCATEPAGESFORMDL DxgkcbAllocatepagesformdl;

NTSTATUS DxgkcbAllocatepagesformdl(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARGCB_ALLOCATEPAGESFORMDL pAllocatePagesForMdl
)
{...}

Parámetros

[in] hAdapter

Identificador del adaptador de pantalla.

[in/out] pAllocatePagesForMdl

Puntero a una estructura DXGKARGCB_ALLOCATEPAGESFORMDL que contiene argumentos para asignar páginas para MDL.

Valor devuelto

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

Comentarios

Esta función de devolución de llamada es una función de controlador de puerto gráfico de Windows equivalente a la función MmAllocatePagesForMdl.

DXGKCB_XXX funciones se implementan mediante Dxgkrnl. Para usar esta función de devolución de llamada, establezca los miembros adecuados de DXGKARGCB_ALLOCATEPAGESFORMDL y, a continuación, llame a DxgkCbAllocatePagesForMdl a través del DXGKRNL_INTERFACE.

Toda la memoria a la que accede la GPU durante las operaciones de paginación o asignada a través de GpuMmu debe asignarse a la IOMMU. Dxgkrnl proporciona devoluciones de llamada al controlador en modo kernel para permitir la asignación y reasignación en un paso.

Nota

Las llamadas a DXGKCB_ALLOCATEPAGESFORMDL se limitan a la restricción MDL de 4 GB PAGE_SIZE y Dxgkrnl siempre especifica la marca MM_ALLOCATE_FULLY_REQUIRED en la llamada interna a la función MmAllocatePagesForMdlEx. El controlador tampoco debe bloquear ninguna memoria. Dxgkrnl administrará las páginas bloqueadas del controlador y, una vez que se reasigna la memoria, es posible que la dirección lógica de las páginas proporcionadas al controlador ya no coincida con las direcciones físicas.

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