NetDmaProviderStop 函式 (netdma.h)
注意 不支援 NetDMA 介面
在 Windows 8 和更新版本中。
語法
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_DEVICE或IRP_MN_STOP_DEVICE IRP 時呼叫 NetDmaProviderStop。
DMA 提供者驅動程式可以呼叫 NetDmaProviderStop 和 NetDmaProviderStart ,在註冊 DMA 提供者之後,以及取消註冊 DMA 提供者之前,應用程式所需的次數。 如果 DMA 引擎在稱為 NetDmaProviderStop 之後重新啟動,DMA 提供者驅動程式可以在 中指定新的屬性 在NetDmaProviderStart 的 ProviderAttributes 參數上NET_DMA_PROVIDER_ATTRIBUTES結構。
NetDMA 介面會等候未完成的 DMA 作業,並在從 NetDmaProviderStop 函式傳回之前釋放所有配置的 DMA 通道。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 在 Windows Vista 中支援 NetDMA 1.0 驅動程式。 |
目標平台 | Universal |
標頭 | netdma.h (包括 Netdma.h) |
IRQL | PASSIVE_LEVEL |