structure DMA_TRANSFER_INFO_V1 (wdm.h)

La structure DMA_TRANSFER_INFO_V1 contient les exigences d’allocation pour une liste de nuages de points/regroupements qui décrit la mémoire tampon de données d’E/S pour un transfert DMA.

Syntaxe

typedef struct _DMA_TRANSFER_INFO_V1 {
  ULONG MapRegisterCount;
  ULONG ScatterGatherElementCount;
  ULONG ScatterGatherListSize;
} DMA_TRANSFER_INFO_V1, *PDMA_TRANSFER_INFO_V1;

Membres

MapRegisterCount

Nombre de registres cartographiques requis pour traduire toutes les adresses physiques de la liste de nuages de points/regroupements en adresses logiques.

ScatterGatherElementCount

Nombre d’éléments de nuage de points/de collecte dans la liste de nuages de points/regroupements. Chaque élément est une structure de type SCATTER_GATHER_ELEMENT.

ScatterGatherListSize

Taille requise, en octets, de la mémoire tampon de nuages de points/de collecte. Cette mémoire tampon contient la liste de points/regroupements qui décrit la mémoire utilisée pour mettre en mémoire tampon les données d’E/S pendant le transfert DMA. La mémoire tampon de nuages de points/de collecte doit être suffisamment grande pour contenir une structure SCATTER_GATHER_LIST et un tableau de structures de SCATTER_GATHER_ELEMENT , ainsi que des données supplémentaires utilisées en interne par le système d’exploitation.

Remarques

Le membre V1 de la structure DMA_TRANSFER_INFO est une structure de type DMA_TRANSFER_INFO_V1.

Les paramètres Mdl, Offset et Length de la routine GetDmaTransferInfo décrivent ensemble la mémoire tampon de données d’E/S pour un transfert DMA. Pour la programmation d’un contrôleur DMA, cette mémoire tampon peut être décrite plus facilement par une liste de nuages de points/regroupements. (Une liste de nuages/de points décrit la mémoire dans une mémoire tampon de données d’E/S, mais ne contient pas cette mémoire.) Un pilote appelle GetDmaTransferInfo pour obtenir les exigences d’allocation pour cette liste de nuages de points/regroupements. GetDmaTransferInfo écrit les exigences d’allocation dans le membre V1 d’une structure DMA_TRANSFER_INFO fournie par l’appelant.

Configuration requise

   
Client minimal pris en charge Prise en charge à partir de Windows 8.
En-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Voir aussi

DMA_TRANSFER_INFO

GetDmaTransferInfo

SCATTER_GATHER_LIST