NetDmaGetVersion 函数 (netdma.h)

  • 项目
注意 不支持 NetDMA 接口

Windows 8 及更高版本。

 

NetDmaGetVersion 函数返回本地计算机支持的 NetDMA 接口版本。

语法

NET_DMA_EXPORT UINT NetDmaGetVersion();

返回值

NetDmaGetVersion 返回包含主版本号和次要版本号的 UINT 值，如下所示：

返回代码 说明
高 16 位
 NetDMA 接口的主版本号。
低 16 位
 NetDMA 接口的次要版本。

注解

NetDMA 提供程序驱动程序可以调用 NetDmaGetVersion 函数来获取 NetDMA 接口的版本。 NetDMA 提供程序必须注册为 NetDMA 提供程序，其版本等于或低于本地计算机支持的 NetDMA 提供程序接口版本。 NetDMA 提供程序驱动程序在 MajorVersion 和 MinorVersion 成员中指定 NetDMA 提供程序的主版本和 次要 版本 它传递给 的NET_DMA_PROVIDER_CHARACTERISTICS 结构 NetDmaRegisterProvider 函数。

注意NetDmaGetVersion 在 NetDMA 版本 1.0 中不可用。 为了避免使用可能会阻止驱动程序加载的函数导入，NetDMA 1.1 或更高版本的提供程序驱动程序必须在调用 NetDmaGetVersion 之前验证 是否存在 NetDmaGetVersion。 若要调用 NetDmaGetVersion，请先调用 NdisGetRoutineAddress 函数以获取入口点，然后，如果 NetDmaGetVersion 可用，请在 NdisGetRoutineAddress 提供的入口点调用 NetDmaGetVersion。 如果提供程序驱动程序无法获取 NetDmaGetVersion 的地址，则支持的 NetDMA 接口必须是版本 1.0。
 
NetDMA 提供程序驱动程序在 IRQL = PASSIVE_LEVEL 调用 NetDmaGetVersion 。

要求

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

另请参阅

NET_DMA_PROVIDER_CHARACTERISTICS

NdisGetRoutineAddress

NetDmaRegisterProvider