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 提供程序驱动程序可以在注册 DMA 提供程序后和取消注册 DMA 提供程序之前调用 NetDmaProviderStop 和 NetDmaProviderStart,只要应用程序需要多次。 如果 DMA 引擎在名为 NetDmaProviderStop 之后重新启动,则 DMA 提供程序驱动程序可以在 中指定新属性netDmaProviderStartProviderAttributes 参数处NET_DMA_PROVIDER_ATTRIBUTES结构。

NetDMA 接口等待未完成的 DMA 操作完成,并在从 NetDmaProviderStop 函数返回之前释放所有分配的 DMA 通道。

要求

要求
最低受支持的客户端 支持 Windows Vista 中的 NetDMA 1.0 驱动程序。
目标平台 通用
标头 netdma.h (包括 Netdma.h)
IRQL PASSIVE_LEVEL

另请参阅

IRP_MN_REMOVE_DEVICE

IRP_MN_STOP_DEVICE

NET_DMA_PROVIDER_ATTRIBUTES

NetDmaDeregisterProvider

NetDmaProviderStart

NetDmaRegisterProvider