Функция 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 с объектом подконфигурации или объектом конфигурации родительского адаптера.

Требования

Требование	Ценность
Целевая платформа	Всеобщий
минимальная версия KMDF	1,21
Минимальная версия UMDF	2.33
Заголовок	netconfiguration.h (include netadaptercx.h)
Библиотека	NetAdapterCxStub.lib
IRQL	пассивный уровень

См. также

NetAdapterOpenConfiguration