NetDmaProviderStart 函数 (netdma.h)

注意 不支持 NetDMA 接口

在 Windows 8 及更高版本中。

 
NetDmaProviderStart 函数通知 NetDMA 接口,即初始化与 DMA 提供程序关联的所有 DMA 通道,并准备好进行 DMA 传输。

语法

NET_DMA_EXPORT VOID NetDmaProviderStart(
  [in] PVOID                        NetDmaProviderHandle,
  [in] PNET_DMA_PROVIDER_ATTRIBUTES ProviderAttributes
);

参数

[in] NetDmaProviderHandle

标识 DMA 提供程序的句柄。 DMA 提供程序驱动程序在调用 NetDMA 接口时从 NetDMA 接口收到此句柄 NetDmaRegisterProvider 函数。

[in] ProviderAttributes

指向 NET_DMA_PROVIDER_ATTRIBUTES 定义 DMA 提供程序的 DMA 设备属性的结构。

返回值

没有

言论

DMA 提供程序调用 NetDmaProviderStart 函数,以通知 NetDMA 接口启动 DMA 提供程序。 DMA 提供程序驱动程序初始化 DMA 引擎,并在处理 IRP_MN_START_DEVICE IRP 时调用 NetDmaProviderStart 函数。

由于特定于应用程序的原因,驱动程序调用 NetDmaProviderStop 函数后,DMA 提供程序驱动程序还可以调用 NetDmaProviderStart。 DMA 提供程序驱动程序调用 NetDmaProviderStop,以通知 NetDMA 接口以前启动的 DMA 提供程序不再可用。

DMA 提供程序驱动程序提供 NetDmaProviderStartProviderAttributes 参数 NET_DMA_PROVIDER_ATTRIBUTES 结构。 NET_DMA_PROVIDER_ATTRIBUTES结构指定 NetDMA 提供程序的配置属性。

在 DMA 提供程序驱动程序调用 NetDmaProviderStart之前,它应准备好处理所有 NetDMA 接口请求,例如分配 DMA 通道和执行 DMA 传输。

要求

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

另请参阅

IRP_MN_START_DEVICE

NET_DMA_PROVIDER_ATTRIBUTES

NetDmaProviderStop

NetDmaRegisterProvider