DMA_ADAPTER 結構 (wdm.h)

  • 發行項

DMA_ADAPTER結構描述指定裝置之 DMA 控制器的系統定義介面。 驅動程式會呼叫 IoGetDmaAdapter 來取得此結構。

語法

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

成員

Version

指定這個結構的版本。 從 Windows 8 開始，可以使用第3版DMA_ADAPTER結構。 對於這個 結構的第 1 版和第 2 版，這個成員會設定為值 1。 如需詳細資訊，請參閱接下來的＜備註＞一節。

Size

指定這個 結構的大小，以位元組為單位。

DmaOperations

包含 DMA 配接器函式指標 之DMA_OPERATIONS 結構的指標。 這個成員所指向的 DMA_OPERATIONS 結構版本取決於 DMA_ADAPTER 結構的版本。 因此，針對第 1 版 的 DMA_ADAPTER 結構， DmaOperations 會指向第 1 版 DMA_OPERATIONS 結構，依此類錯。 如需結構版本的詳細資訊，請參閱下列一節。

備註

使用 DMA 傳輸資料的裝置驅動程式會使用此結構來取得能夠使用 DMA 控制器的函式位址。 驅動程式通常會藉由呼叫 IoGetDmaAdapter 例程來取得此結構。 驅動程式也可以藉由查詢 BUS_INTERFACE_STANDARD 介面來取得此結構。

當 IoGetDmaAdapter 例程傳回第 1 版或第 2 版 DMA_ADAPTER 結構的指標時，此例程一律會將這個結構的 Version 成員設定為 1。 因此，呼叫端無法使用 Version 成員來區分第 1 版和第 2 版 DMA_ADAPTER 結構。 如需如何判斷此例程所傳回 之DMA_ADAPTER 結構版本的詳細資訊，請參閱 IoGetDmaAdapter。

規格需求

需求 值
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)

另請參閱

BUS_INTERFACE_STANDARD

DMA_OPERATIONS

IoGetDmaAdapter