DMA_TRANSFER_INFO_V1-Struktur (wdm.h)
Die DMA_TRANSFER_INFO_V1-Struktur enthält die Zuordnungsanforderungen für eine Scatter/Gather-Liste, 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;
Member
MapRegisterCount
Die Anzahl der Kartenregister, die erforderlich sind, um alle physischen Adressen in der Punkt-/Sammlungsliste in logische Adressen zu übersetzen.
ScatterGatherElementCount
Die Anzahl der Scatter-/Gather-Elemente in der Scatter/Gather-Liste. Jedes Element ist eine Struktur vom Typ SCATTER_GATHER_ELEMENT.
ScatterGatherListSize
Die erforderliche Größe des Scatter/Gather-Puffers in Bytes. Dieser Puffer enthält die Scatter/Gather-Liste, die den Arbeitsspeicher beschreibt, der zum Puffern von E/A-Daten während der DMA-Übertragung verwendet wird. Der Scatter/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.
Hinweise
Das V1-Element der DMA_TRANSFER_INFO-Struktur ist eine Struktur vom Typ DMA_TRANSFER_INFO_V1.
Die Parameter Mdl, Offset und Length für die GetDmaTransferInfo-Routine beschreiben zusammen den E/A-Datenpuffer für eine DMA-Übertragung. Zum Programmieren eines DMA-Controllers kann dieser Puffer bequemer durch eine Scatter/Gather-Liste beschrieben werden. (Eine Scatter/Gather-Liste 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 Scatter/Gather-Liste abzurufen. GetDmaTransferInfo schreibt die Zuordnungsanforderungen in das V1-Member einer vom Aufrufer bereitgestellten DMA_TRANSFER_INFO-Struktur .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Wird ab Windows 8 unterstützt. |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |