Функция NetAdapterOpenConfiguration (netadapter.h)

Статья
05/23/2024

Функция NetAdapterOpenConfiguration открывает базу данных конфигурации сетевого адаптера.

Синтаксис

NTSTATUS NetAdapterOpenConfiguration(
  [_In_]     NETADAPTER            Adapter,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
  [_Out_]    NETCONFIGURATION      *Configuration
);

Параметры

[_In_] Adapter

Объект сетевого адаптера, созданный клиентом перед вызовом NetAdapterCreate.

[_In_opt_] ConfigurationAttributes

Указатель на структуру WDF_OBJECT_ATTRIBUTES , содержащую предоставленные драйвером атрибуты для нового объекта конфигурации. Этот параметр является необязательным и может быть WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] Configuration

Указатель на расположение, которое получает дескриптор нового объекта конфигурации адаптера.

Возвращаемое значение

Функция возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае эта функция может вернуть соответствующий код ошибки NTSTATUS.

Если клиент предоставляет WDF_OBJECT_ATTRIBUTES, он задает значение NULL для ParentObject. Объект конфигурации адаптера автоматически становится родительским объектом адаптера.

В результате WDF автоматически удаляет объект конфигурации при удалении адаптера. Однако клиент может вручную удалить объект конфигурации, вызвав WdfObjectDelete, как правило, из функции обратного вызова EVT_WDF_OBJECT_CONTEXT_CLEANUP .

Требования

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

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

Доступ к сведениям о конфигурации

NetConfigurationClose

Поделиться через