DMA_TRANSFER_INFO_V1 Struktur (wdm.h)

Die DMA_TRANSFER_INFO_V1 Struktur enthält die Zuordnungsanforderungen für eine Punkt-/Sammelliste, die den I/O-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-/Sammelliste in logische Adressen zu übersetzen.

ScatterGatherElementCount

Die Anzahl der Punkt-/Sammelelemente in der Punkt-/Sammelliste. Jedes Element ist eine Struktur des Typs SCATTER_GATHER_ELEMENT.

ScatterGatherListSize

Die erforderliche Größe des Punkt-/Sammelpuffers in Bytes. Dieser Puffer enthält die Punkt-/Sammelliste, die den Speicher beschreibt, der zum Puffern von E/A-Daten während der DMA-Übertragung verwendet wird. Der Punkt-/Sammelpuffer 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 des Typs DMA_TRANSFER_INFO_V1.

Die Parameter Mdl, Offset und Length für die GetDmaTransferInfo-Routine beschreiben zusammen den I/O-Datenpuffer für eine DMA-Übertragung. Zum Programmieren eines DMA-Controllers kann dieser Puffer bequemer durch eine Punkt-/Sammelliste beschrieben werden. (Eine Punkt-/Sammelliste 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-/Sammelliste abzurufen. GetDmaTransferInfo schreibt die Zuordnungsanforderungen in das V1-Element eines aufrufers bereitgestellten DMA_TRANSFER_INFO Struktur.

Anforderungen

   
Unterstützte Mindestversion (Client) Unterstützt ab Windows 8.
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Weitere Informationen

DMA_TRANSFER_INFO

GetDmaTransferInfo

SCATTER_GATHER_LIST