DMA_TRANSFER_INFO_V1 Struktur (wdm.h)
Die DMA_TRANSFER_INFO_V1-Struktur enthält die Zuordnungsanforderungen für eine Punkt-/Sammelliste, die den E/A-Datenpuffer für eine DMA-Übertragung beschreibt.
Syntax
typedef struct _DMA_TRANSFER_INFO_V1 {
ULONG MapRegisterCount;
ULONG ScatterGatherElementCount;
ULONG ScatterGatherListSize;
} DMA_TRANSFER_INFO_V1, *PDMA_TRANSFER_INFO_V1;
Angehörige
MapRegisterCount
Die Anzahl der Kartenregister, die erforderlich sind, um alle physischen Adressen in der Punkt-/Gather-Liste in logische Adressen zu übersetzen.
ScatterGatherElementCount
Die Anzahl der XY/Gather-Elemente in der Punkt-/Gather-Liste. Jedes Element ist eine Struktur vom Typ SCATTER_GATHER_ELEMENT.
ScatterGatherListSize
Die erforderliche Größe des Punkt-/Gatherpuffers in Byte. Dieser Puffer enthält die Punkt/Erfassungsliste, die den Speicher beschreibt, der während der DMA-Übertragung zum Puffern von E/A-Daten verwendet wird. Der Punkt/Gather-Puffer muss groß genug sein, um eine SCATTER_GATHER_LIST Struktur und ein Array von SCATTER_GATHER_ELEMENT Strukturen sowie zusätzliche Daten zu enthalten, die intern vom Betriebssystem verwendet werden.
Bemerkungen
Das V1- Element der DMA_TRANSFER_INFO-Struktur ist eine Struktur vom Typ DMA_TRANSFER_INFO_V1.
Die Mdl, Offsetund Length Parameter für die GetDmaTransferInfo Routine beschreiben zusammen den E/A-Datenpuffer für eine DMA-Übertragung. Für die Programmierung eines DMA-Controllers kann dieser Puffer bequemer durch eine Punkt/Gather-Liste beschrieben werden. (Eine Punkt-/Erfassungsliste beschreibt den Speicher in einem E/A-Datenpuffer, enthält diesen Speicher jedoch nicht.) Ein Treiber ruft GetDmaTransferInfo auf, um die Zuordnungsanforderungen für diese Punkt/Gather-Liste abzurufen. GetDmaTransferInfo schreibt die Zuordnungsanforderungen in das V1- Mitglied einer vom Aufrufer bereitgestellten DMA_TRANSFER_INFO-Struktur.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Wird ab Windows 8 unterstützt. |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |