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) |