NetDmaProviderStart 函式 (netdma.h)

語法

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 ，以因應用程式特定原因而呼叫 NetDmaProviderStop 函式。 DMA 提供者驅動程式會呼叫 NetDmaProviderStop ，以通知 NetDMA 介面先前啟動的 DMA 提供者已無法使用。

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

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

規格需求

另請參閱

IRP_MN_START_DEVICE

NET_DMA_PROVIDER_ATTRIBUTES

NetDmaProviderStop

NetDmaRegisterProvider