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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour