DMA_TRANSFER_INFO_V1-Struktur (wdm.h)

  • Artikel

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)

Weitere Informationen

DMA_TRANSFER_INFO

GetDmaTransferInfo

SCATTER_GATHER_LIST