NetDmaProviderStop 函数 (netdma.h)

项目
08/07/2023

注意不支持 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_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