Функция 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, он задает значение NULL для ParentObject. По умолчанию вложенная конфигурация является родительской для существующего объекта конфигурации адаптера.

Драйвер клиента закрывает подконфигурацию, вызывая NetConfigurationClose с объектом конфигурации sub или родительским объектом конфигурации адаптера.

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1.21
Минимальная версия UMDF	2.33
Верхняя часть	netconfiguration.h (включая netadaptercx.h)
Библиотека	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL

См. также раздел

NetAdapterOpenConfiguration

NetConfigurationOpenSubConfiguration