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 提供程序驱动程序可以在注册 DMA 提供程序后和取消注册 DMA 提供程序之前调用 NetDmaProviderStop 和 NetDmaProviderStart,只要应用程序需要多次。 如果 DMA 引擎在名为 NetDmaProviderStop 之后重新启动,则 DMA 提供程序驱动程序可以在 中指定新属性netDmaProviderStart 的 ProviderAttributes 参数处NET_DMA_PROVIDER_ATTRIBUTES结构。
NetDMA 接口等待未完成的 DMA 操作完成,并在从 NetDmaProviderStop 函数返回之前释放所有分配的 DMA 通道。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 支持 Windows Vista 中的 NetDMA 1.0 驱动程序。 |
目标平台 | 通用 |
标头 | netdma.h (包括 Netdma.h) |
IRQL | PASSIVE_LEVEL |