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