DMA_ADAPTER-Struktur (wdm.h)

  • Artikel

Die DMA_ADAPTER-Struktur beschreibt eine systemdefinierte Schnittstelle zu einem DMA-Controller für ein bestimmtes Gerät. Ein Treiber ruft IoGetDmaAdapter auf, um diese Struktur zu erhalten.

Syntax

typedef struct _DMA_ADAPTER {
  USHORT          Version;
  USHORT          Size;
  PDMA_OPERATIONS DmaOperations;
} *PADAPTER_OBJECT, DMA_ADAPTER, *PDMA_ADAPTER;

Member

Version

Gibt die Version dieser Struktur an. Version 3 der DMA_ADAPTER-Struktur ist ab Windows 8 verfügbar. Für die Versionen 1 und 2 dieser Struktur wird dieser Member auf den Wert 1 festgelegt. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Size

Gibt die Größe dieser Struktur in Bytes an.

DmaOperations

Zeiger auf eine DMA_OPERATIONS Struktur, die Zeiger auf DMA-Adapterfunktionen enthält. Die Version der DMA_OPERATIONS-Struktur , auf die dieser Member zeigt, wird von der Version der DMA_ADAPTER-Struktur bestimmt. Daher verweist DmaOperations für Version 1 der DMA_ADAPTER-Struktur auf Version 1 der DMA_OPERATIONS-Struktur usw. Weitere Informationen zu Strukturversionen finden Sie im folgenden Abschnitt hinweise.

Hinweise

Treiber für Geräte, die DMA zum Übertragen von Daten verwenden, verwenden diese Struktur, um die Adressen von Funktionen abzurufen, die die Verwendung eines DMA-Controllers ermöglichen. In der Regel erhalten Treiber diese Struktur, indem sie die IoGetDmaAdapter-Routine aufrufen. Treiber können diese Struktur auch abrufen, indem sie die BUS_INTERFACE_STANDARD-Schnittstelle abfragen.

Wenn die IoGetDmaAdapter-Routine einen Zeiger auf Version 1 oder Version 2 der DMA_ADAPTER-Struktur zurückgibt, legt diese Routine den Member Version dieser Struktur immer auf 1 fest. Daher kann der Aufrufer den Versionsmember nicht verwenden, um zwischen Versionen 1 und 2 der DMA_ADAPTER-Struktur zu unterscheiden. Weitere Informationen zum Bestimmen der Version einer DMA_ADAPTER Struktur, die von dieser Routine zurückgegeben wird, finden Sie unter IoGetDmaAdapter.

Anforderungen

Anforderung Wert
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)

Weitere Informationen

BUS_INTERFACE_STANDARD

DMA_OPERATIONS

IoGetDmaAdapter