NetDmaProviderStop 函数 (netdma.h)
在 Windows 8 及更高版本中。
语法
NET_DMA_EXPORT VOID NetDmaProviderStop(
[in] PVOID NetDmaProviderHandle
);
参数
[in] NetDmaProviderHandle
标识 DMA 提供程序的句柄。 DMA 提供程序驱动程序在调用 NetDMA 接口时从 NetDMA 接口收到此句柄 NetDmaRegisterProvider 函数。
返回值
没有
言论
DMA 提供程序驱动程序调用 NetDmaProviderStop 函数,以通知 NetDMA 接口,通过调用 NetDmaProviderStart 函数启动的 DMA 引擎不再可用。
DMA 提供程序驱动程序必须先调用 NetDmaProviderStop,然后才能调用 NetDmaDeregisterProvider 函数来取消注册 DMA 提供程序。
处理 IRP_MN_REMOVE_DEVICE 或 IRP_MN_STOP_DEVICE IRP 时,DMA 提供程序驱动程序通常调用 NetDmaProviderStop。
DMA 提供程序驱动程序可以调用 NetDmaProviderStop,NetDmaProviderStart 注册 DMA 提供程序之后以及注销 DMA 提供程序之前,应用程序所需的次数。 如果在调用 NetDmaProviderStop后重新启动 DMA 引擎,则 DMA 提供程序驱动程序可以在 中指定新属性 NetDmaProviderStartProviderAttributes 参数 NET_DMA_PROVIDER_ATTRIBUTES 结构。
NetDMA 接口等待未完成的 DMA作并释放所有已分配的 DMA 通道,然后再从 NetDmaProviderStop 函数返回。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows Vista 中支持 NetDMA 1.0 驱动程序。 |
目标平台 | 普遍 |
标头 | netdma.h (包括 Netdma.h) |
IRQL | PASSIVE_LEVEL |