DXGKCB_ALLOCATEADL fonction de rappel (d3dkmddi.h)
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 |