NdisOpenProtocolConfiguration 函数 （ndis.h）
注释 NDIS 5。 x 已被弃用，并被 NDIS 6 取代。 x。 有关新的 NDIS 驱动程序开发，请参阅从 Windows Vista 开始网络驱动程序。 有关移植 NDIS 5 的信息。 将 x 驱动程序 到 NDIS 6。 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 驱动程序（实际上为适配器命名），应打开注册表协议部分中每个适配器参数键。 对于 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 驱动程序。
要求
| 要求 | 价值 |
|---|---|
| 标头 | ndis.h （包括 Ndis.h） |
| 库 | Ndis.lib |
| IRQL | PASSIVE_LEVEL |