DMA_TRANSFER_INFO_V2-Struktur (wdm.h)

  • Artikel

Enthält die Zuordnungsanforderungen für eine Punkt-/Sammlungsliste, die den E/A-Datenpuffer für eine DMA-Übertragung beschreibt.

Syntax

typedef struct _DMA_TRANSFER_INFO_V2 {
  ULONG MapRegisterCount;
  ULONG ScatterGatherElementCount;
  ULONG ScatterGatherListSize;
  ULONG LogicalPageCount;
} DMA_TRANSFER_INFO_V2, *PDMA_TRANSFER_INFO_V2;

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 Punkt-/Gather-Liste. Jedes Element ist eine Struktur vom Typ SCATTER_GATHER_ELEMENT.

ScatterGatherListSize

Die erforderliche Größe des Punkt-/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 Punkt/Sammlungspuffer 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.

LogicalPageCount

Die Anzahl der logischen Seiten.

Hinweise

Das V2-Element der DMA_TRANSFER_INFO-Struktur ist eine Struktur vom Typ DMA_TRANSFER_INFO_V2.

Die Parameter Mdl, Offset und Length 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 Scatter/Gather-Liste beschrieben werden. (Eine Punkt-/Sammlungsliste beschreibt den Arbeitsspeicher in einem E/A-Datenpuffer, enthält diesen Speicher jedoch nicht.) Ein Treiber ruft GetDmaTransferInfo auf, um die Zuordnungsanforderungen für diese Punkt-/Sammlungsliste abzurufen. GetDmaTransferInfo schreibt die Zuordnungsanforderungen in das V1-Element einer vom Aufrufer bereitgestellten DMA_TRANSFER_INFO struktur.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1809.
Kopfzeile wdm.h