DMA_ADAPTER Struktur (wdm.h)

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

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 Versionen 1 und 2 dieser Struktur wird dieses Element auf den Wert 1 festgelegt. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Size

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

DmaOperations

Zeiger auf eine DMA_OPERATIONS Struktur, die Zeiger auf DMA-Adapterfunktionen enthält. Die Version der DMA_OPERATIONS Struktur, auf die dieses Element verweist, wird durch die Version der DMA_ADAPTER-Struktur bestimmt. So verweist DmaOperations für Version 1 der DMA_ADAPTER-Struktur auf Version 1 der DMA_OPERATIONS Struktur und so weiter. Weitere Informationen zu Strukturversionen finden Sie im folgenden Abschnitt "Hinweise".

Bemerkungen

Treiber für Geräte, die DMA verwenden, um Daten zu übertragen, 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.

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

Anforderungen

   
Header wdm.h (enthalten Wdm.h, Ntddk.h, Ntifs.h)

Weitere Informationen

BUS_INTERFACE_STANDARD

DMA_OPERATIONS

IoGetDmaAdapter