NetConfigurationOpenSubConfiguration 函数 (netconfiguration.h)
打开指定适配器配置对象的子配置。
语法
NTSTATUS NetConfigurationOpenSubConfiguration(
[_In_] NETCONFIGURATION Configuration,
[_In_] PCUNICODE_STRING SubConfigurationName,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *SubConfigurationAttributes,
[_Out_] NETCONFIGURATION *SubConfiguration
);
参数
[_In_] Configuration
在之前调用 NetAdapterOpenConfiguration 或NetConfigurationOpenSubConfiguration 时打开的适配器配置对象的句柄。
[_In_] SubConfigurationName
指向字符串的指针，指定要打开的子配置的名称。
[_In_opt_] SubConfigurationAttributes
指向 WDF_OBJECT_ATTRIBUTES 结构的指针，该结构包含新配置对象的驱动程序提供的属性。 此参数是可选的，可以WDF_NO_OBJECT_ATTRIBUTES。
[_Out_] SubConfiguration
指向接收新子配置对象的句柄的位置的指针。
返回值
如果操作成功，函数将返回STATUS_SUCCESS。 否则，此函数可能会返回相应的 NTSTATUS 错误代码。
注解
如果客户端提供WDF_OBJECT_ATTRIBUTES，则为 ParentObject 指定 NULL。 默认情况下，子配置是现有适配器配置对象的父级。
客户端驱动程序通过使用子配置对象或父适配器配置对象调用 NetConfigurationClose 来关闭子配置。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 通用 |
| 最低 KMDF 版本 | 1.21 |
| 最低 UMDF 版本 | 2.33 |
| 标头 | netconfiguration.h (包括 netadaptercx.h) |
| Library | NetAdapterCxStub.lib |
| IRQL | PASSIVE_LEVEL |