Partager via


DMA_TRANSFER_INFO_V1 structure (wdm.h)

La structure DMA_TRANSFER_INFO_V1 contient les exigences d’allocation pour une liste 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 points/regroupements en adresses logiques.

ScatterGatherElementCount

Nombre d’éléments de nuages de points/regroupements dans la liste 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/regroupements. 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 diffusion/collecte doit être suffisamment grande pour contenir une structure SCATTER_GATHER_LIST et un tableau de structures 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 points/regroupements. (Une liste de points/regroupements 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 points/regroupements. GetDmaTransferInfo écrit les exigences d’allocation dans le membre V1 d’une structure de DMA_TRANSFER_INFO fournie par l’appelant .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris 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