structure DMA_ADAPTER (wdm.h)
La structure DMA_ADAPTER décrit une interface définie par le système à un contrôleur DMA pour un appareil donné. Un pilote appelle IoGetDmaAdapter pour obtenir cette structure.
Syntaxe
typedef struct _DMA_ADAPTER {
USHORT Version;
USHORT Size;
PDMA_OPERATIONS DmaOperations;
} *PADAPTER_OBJECT, DMA_ADAPTER, *PDMA_ADAPTER;
Membres
Version
Spécifie la version de cette structure. La version 3 de la structure DMA_ADAPTER est disponible à partir de Windows 8. Pour les versions 1 et 2 de cette structure, ce membre est défini sur la valeur 1. Pour plus d'informations, consultez la section Notes qui suit.
Size
Spécifie la taille, en octets, de cette structure.
DmaOperations
Pointeur vers une structure de DMA_OPERATIONS qui contient des pointeurs vers les fonctions d’adaptateur DMA. La version de la structure DMA_OPERATIONS vers laquelle pointe ce membre est déterminée par la version de la structure DMA_ADAPTER . Ainsi, pour la version 1 de la structure DMA_ADAPTER , DmaOperations pointe vers la version 1 de la structure DMA_OPERATIONS , et ainsi de suite. Pour plus d’informations sur les versions de structure, consultez la section Remarques suivante.
Remarques
Les pilotes pour les appareils qui utilisent DMA pour transférer des données utilisent cette structure pour obtenir les adresses des fonctions qui permettent l’utilisation d’un contrôleur DMA. En règle générale, les pilotes obtiennent cette structure en appelant la routine IoGetDmaAdapter . Les pilotes peuvent également obtenir cette structure en interrogeant l’interface BUS_INTERFACE_STANDARD .
Lorsque la routine IoGetDmaAdapter retourne un pointeur vers la version 1 ou la version 2 de la structure DMA_ADAPTER , cette routine définit toujours le membre Version de cette structure sur 1. Par conséquent, l’appelant ne peut pas utiliser le membre Version pour faire la distinction entre les versions 1 et 2 de la structure DMA_ADAPTER . Pour plus d’informations sur la façon de déterminer la version d’une structure DMA_ADAPTER retournée par cette routine, consultez IoGetDmaAdapter.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h) |