NetDmaProviderStart 函式 （netdma.h）

附注 不支援 NetDMA 介面

在 Windows 8 和更新版本中。

 

NetDmaProviderStart 函式會通知 NetDMA 介面，所有與 DMA 提供者相關聯的 DMA 通道都會初始化並準備好進行 DMA 傳輸。

語法

NET_DMA_EXPORT VOID NetDmaProviderStart(
  [in] PVOID                        NetDmaProviderHandle,
  [in] PNET_DMA_PROVIDER_ATTRIBUTES ProviderAttributes
);

參數

[in] NetDmaProviderHandle

識別 DMA 提供者的句柄。 DMA 提供者驅動程式在呼叫 時從 NetDMA 介面收到此句柄 NetDmaRegisterProvider 函式。

[in] ProviderAttributes

的指標 NET_DMA_PROVIDER_ATTRIBUTES 結構，定義 DMA 提供者的 DMA 裝置屬性。

傳回值

沒有

言論

DMA 提供者會呼叫 NetDmaProviderStart 函式，以通知 NetDMA 介面 DMA 提供者已啟動。 DMA 提供者驅動程式會初始化 DMA 引擎，並在處理 IRP_MN_START_DEVICE IRP 時呼叫 NetDmaProviderStart 函式。

DMA 提供者驅動程式也可以在驅動程式呼叫 NetDmaProviderStop 函式之後，呼叫 NetDmaProviderStart。 DMA 提供者驅動程式會呼叫 NetDmaProviderStop，以通知 NetDMA 介面先前啟動的 DMA 提供者已無法使用。

DMA 提供者驅動程式會提供 NetDmaProviderStartProviderAttributes 參數的 NET_DMA_PROVIDER_ATTRIBUTES 結構。 NET_DMA_PROVIDER_ATTRIBUTES 結構會指定 NetDMA 提供者的組態屬性。

在 DMA 提供者驅動程式呼叫 NetDmaProviderStart之前，應該已準備好處理所有 NetDMA 介面要求，例如配置 DMA 通道和執行 DMA 傳輸。

要求

要求	價值
最低支援的用戶端	支援 Windows Vista 中的 NetDMA 1.0 驅動程式。
目標平臺	普遍
標頭	netdma.h （包括 Netdma.h）
IRQL	PASSIVE_LEVEL

另請參閱

IRP_MN_START_DEVICE

NET_DMA_PROVIDER_ATTRIBUTES

NetDmaProviderStop

NetDmaRegisterProvider