DXGKCB_MAPMDLTOIOMMU fonction de rappel (d3dkmddi.h)

Article
02/06/2025

Un pilote miniport d’affichage en mode noyau appelle DXGKCB_MAPMDLTOIOMMU pour mapper une liste de descripteurs de mémoire (MDL) à l’IOMMU afin que la mémoire sous-jacente soit accessible par le GPU.

Syntaxe

DXGKCB_MAPMDLTOIOMMU DxgkcbMapmdltoiommu;

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

Paramètres

[in] hAdapter

Handle vers un adaptateur d’affichage. Le pilote fournit ce handle pour le périphérique maître/prospect dans la chaîne LDA.

[in/out] pMapMdlToIoMmu

Pointeur vers une structure DXGKARGCB_MAPMDLTOIOMMU qui contient un handle vers la mémoire.

Valeur de retour

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

Remarques

DXGKCB_XXX fonctions sont implémentées par Dxgkrnl. Pour utiliser cette fonction de rappel, définissez le membre approprié de DXGKARGCB_MAPMDLTOIOMMU, puis appelez DxgkCbMapMdlToIoMmu via le DXGKRNL_INTERFACE.

Si le pilote utilise ce rappel, il est chargé de s’assurer que la durée de vie du MDL dépasse l’appel de DXGKCB_UNMAPMDLFROMIOMMU correspondant. Sinon, l’appel DXGKCB_UNMAPMDLFROMIOMMU a un comportement non défini et peut entraîner une sécurité compromise des pages à partir du MDL. Les pages peuvent être réaffectées par Mm au moment où elles ne sont pas mappées.

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