DXGKCB_ALLOCATEPAGESFORMDL fonction de rappel (d3dkmddi.h)

Article
02/06/2025

DXGKCB_ALLOCATEPAGESFORMDL alloue des pages de mémoire physique pour une liste de descripteurs de mémoire (MDL) à mapper à l’espace d’adressage logique de l’IOMMU.

Syntaxe

DXGKCB_ALLOCATEPAGESFORMDL DxgkcbAllocatepagesformdl;

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

Paramètres

[in] hAdapter

Handle de l’adaptateur d’affichage.

[in/out] pAllocatePagesForMdl

Pointeur vers une structure DXGKARGCB_ALLOCATEPAGESFORMDL qui contient des arguments pour allouer des pages pour MDL.

Valeur de retour

Retournez STATUS_SUCCESS si l’opération réussit. Sinon, retournez un code d’erreur NTSTATUS approprié.

Remarques

Cette fonction de rappel est une fonction de pilote de port graphique Windows équivalente à la fonction MmAllocatePagesForMdl.

DXGKCB_XXX fonctions sont implémentées par Dxgkrnl. Pour utiliser cette fonction de rappel, définissez les membres appropriés de DXGKARGCB_ALLOCATEPAGESFORMDL, puis appelez DxgkCbAllocatePagesForMdl via le DXGKRNL_INTERFACE.

Toute la mémoire accessible par le GPU pendant les opérations de pagination ou mappée via gpuMmu doit être mappée à l’IOMMU. Dxgkrnl fournit des rappels au pilote en mode noyau pour autoriser l’allocation et le remapping en une seule étape.

Note

Les appels à DXGKCB_ALLOCATEPAGESFORMDL sont limités à la restriction MDL de 4 Go PAGE_SIZE et Dxgkrnl spécifie toujours l’indicateur MM_ALLOCATE_FULLY_REQUIRED dans l’appel interne à fonction MmAllocatePagesForMdlEx. Le pilote ne doit pas non plus verrouiller de mémoire. Dxgkrnl gérera les pages verrouillées pour le pilote, et une fois que la mémoire est remappée, l’adresse logique des pages fournies au pilote peut ne plus correspondre aux adresses physiques.

Pour plus d’informations, consultez d’isolation GPU basée sur IOMMU.