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

另请参阅

NetAdapterOpenConfiguration

NetConfigurationOpenSubConfiguration