NdisOpenProtocolConfiguration 函数 (ndis.h)

  • 项目

注意 NDIS 5。 x 已弃用，由 NDIS 6 取代。 x。 有关新的 NDIS 驱动程序开发，请参阅 从 Windows Vista 开始的网络驱动程序。 有关移植 NDIS 5 的信息。 NDIS 6 的 x 驱动程序。 x，请参阅 将 NDIS 5.x 驱动程序移植到 NDIS 6.0。

NdisOpenProtocolConfiguration 返回用于存储协议驱动程序的每个适配器信息的注册表项的句柄。

语法

void NdisOpenProtocolConfiguration(
  [out] PNDIS_STATUS  Status,
  [out] PNDIS_HANDLE  ConfigurationHandle,
  [in]  PCNDIS_STRING ProtocolSection
);

参数

[out] Status

指向调用方提供的变量的指针，该变量设置为NDIS_STATUS_SUCCESS或从此函数返回时失败状态。

[out] ConfigurationHandle

指向调用方提供的变量的指针，在此变量中，此函数返回调用方稍后将绑定到的命名微型端口驱动程序的注册表项的句柄。 此键下的值条目包含协议安装的特定于适配器的信息。

[in] ProtocolSection

指向调用方提供的NDIS_STRING类型的指针，该类型包含系统默认字符集中指定的计数字符串。 此计数字符串将 NDIS NIC 驱动程序命名为 NDIS NIC 驱动程序，实际上为适配器，应为其打开注册表协议部分中的每适配器参数键。 对于 Windows 2000 及更高版本的协议，此计数字符串包含 Unicode 字符。 也就是说，对于 Windows 2000 及更高版本，NDIS 将NDIS_STRING类型定义为 UNICODE_STRING 类型。

此指针是指向调用方 ProtocolBindAdapter 函数的 SystemSpecific1 输入参数。

返回值

无

备注

NdisOpenProtocolConfiguration 返回调用方随后可以传递给 Ndis 的句柄。用于 在注册表中检索或存储信息的配置函数。

协议驱动程序调用 NdisOpenProtocolConfiguration 以获取随后要传递给其他 Ndis 的注册表项句柄。配置 函数（如 NdisRead/WriteConfiguration 或 NdisOpenConfigurationKeyByName/Index）如果其安装文件将特定于适配器的配置信息存储在协议从中设置其绑定的注册表的协议部分中。

协议可以调用 NdisOpenConfigurationKeyByName 或 NdisOpenConfigurationKeyByIndex ，以打开 NdisOpenProtocolConfiguration 为其返回句柄的注册表项的任何子项。

Windows 2000 及更高版本的协议调用内核模式支持例程来打开其自己的特定于协议的注册表项。 有关这些支持例程的详细信息，请参阅 Kernel-Mode 支持例程 和 电源管理支持例程摘要。

  • 目标平台： 通用
  • 版本：Windows Vista 中的 NDIS 6.0 驱动程序不支持。 请改用 NdisOpenConfigurationEx。 支持 Windows Vista 和 Windows XP 中的 NDIS 5.1 驱动程序。

要求

要求 值
Header ndis.h (包括 Ndis.h)
Library Ndis.lib
IRQL PASSIVE_LEVEL

另请参阅