DXGKCB_MAPMDLTOIOMMU fonction de rappel (d3dkmddi.h)

Article
02/26/2024

Un pilote miniport d’affichage en mode noyau appelle DXGKCB_MAPMDLTOIOMMU pour mapper une liste de descripteurs 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 d’un adaptateur d’affichage. Le pilote fournit ce handle pour le périphérique master/prospect dans la chaîne LDA.

[in/out] pMapMdlToIoMmu

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

Valeur retournée

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 de la MDL dépasse le DXGKCB_UNMAPMDLFROMIOMMU appel correspondant. Sinon, l’appel DXGKCB_UNMAPMDLFROMIOMMU a un comportement non défini et peut entraîner une sécurité compromise des pages à partir de la MDL. Les pages peuvent être réaffectées par Mm au moment où elles sont démaquées.

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