structure DMA_ADAPTER (wdm.h)

  • Article

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)

Voir aussi

BUS_INTERFACE_STANDARD

DMA_OPERATIONS

IoGetDmaAdapter