DXGKCB_ALLOCATEADL fonction de rappel (d3dkmddi.h)

  • Article

DXGKCB_ALLOCATEADL crée une liste de descripteurs d’adresses (ADL).

Syntaxe

DXGKCB_ALLOCATEADL DxgkcbAllocateadl;

NTSTATUS DxgkcbAllocateadl(
  [in/out] IN_OUT_PDXGKARGCB_ALLOCATE_ADL pArgs
)
{...}

Paramètres

[in/out] pArgs

Pointeur vers une structure DXGKARGCB_ALLOCATE_ADL qui contient des informations sur l’ADL à créer. En cas de réussite, retourne une structure DXGK_ADL avec une liste d’adresses de page qui peuvent être utilisées pour programmer le matériel.

Valeur retournée

Retourne STATUS_SUCCESS si l’opération réussit. Sinon, retourne un code d’erreur NTSTATUS approprié, tel que STATUS_INVALID_PARAMETER.

Remarques

Les fonctions DXGKCB_ALLOCATEADL et DXGKCB_FREEADL sont utilisées pour créer et détruire des ACL qui décrivent des adresses mémoire qui peuvent être programmées (mappées) au GPU. La mémoire sous-jacente peut pointer vers la mémoire logique ou physique selon que l’IOMMU est utilisé, le pilote ne doit donc pas essayer de supposer que ces adresses représentent des pages physiques.

Lorsqu’un ADL est alloué à partir de l’objet physique, Dxgkrnl garantit que cette mémoire reste verrouillée et qu’elle n’est pas paginable pendant toute la durée de vie de l’ADL.

Pour plus d’informations , consultez Remapping IOMMU DMA .

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

Configuration requise

Condition requise Valeur
Serveur minimal pris en charge Windows Server 2022 (WDDM 2.9)
En-tête d3dkmddi.h
IRQL PASSIVE_LEVEL

Voir aussi

DXGKARGCB_ALLOCATE_ADL

DXGKCB_FREEADL

DXGKRNL_INTERFACE