共用方式為


NetDmaProviderStop 函式 (netdma.h)

注意 不支援 NetDMA 介面

在 Windows 8 和更新版本中。

 
NetDmaProviderStop 函式會通知 NetDMA 介面,所有與 DMA 提供者相關聯的 DMA 通道都不再可供 DMA 傳輸使用。

語法

NET_DMA_EXPORT VOID NetDmaProviderStop(
  [in] PVOID NetDmaProviderHandle
);

參數

[in] NetDmaProviderHandle

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

傳回值

備註

DMA 提供者驅動程式會呼叫 NetDmaProviderStop 函式,通知 NetDMA 介面已無法使用呼叫 NetDmaProviderStart 函式所啟動的 DMA 引擎。

DMA 提供者驅動程式必須先呼叫 NetDmaProviderStop ,才能呼叫 NetDmaDeregisterProvider 函式來取消註冊 DMA 提供者。

DMA 提供者驅動程式通常會在處理IRP_MN_REMOVE_DEVICEIRP_MN_STOP_DEVICE IRP 時呼叫 NetDmaProviderStop

DMA 提供者驅動程式可以呼叫 NetDmaProviderStopNetDmaProviderStart ,在註冊 DMA 提供者之後,以及取消註冊 DMA 提供者之前,應用程式所需的次數。 如果 DMA 引擎在稱為 NetDmaProviderStop 之後重新啟動,DMA 提供者驅動程式可以在 中指定新的屬性NetDmaProviderStartProviderAttributes 參數上NET_DMA_PROVIDER_ATTRIBUTES結構。

NetDMA 介面會等候未完成的 DMA 作業,並在從 NetDmaProviderStop 函式傳回之前釋放所有配置的 DMA 通道。

規格需求

需求
最低支援的用戶端 在 Windows Vista 中支援 NetDMA 1.0 驅動程式。
目標平台 Universal
標頭 netdma.h (包括 Netdma.h)
IRQL PASSIVE_LEVEL

另請參閱

IRP_MN_REMOVE_DEVICE

IRP_MN_STOP_DEVICE

NET_DMA_PROVIDER_ATTRIBUTES

NetDmaDeregisterProvider

NetDmaProviderStart

NetDmaRegisterProvider