Функция 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 |