Функция NetDeviceOpenConfiguration (netdevice.h)

Статья
05/23/2024

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

Синтаксис

NTSTATUS NetDeviceOpenConfiguration(
  [_In_]     WDFDEVICE             Device,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
  [_Out_]    NETCONFIGURATION      *Configuration
);

Параметры

[_In_] Device

Объект WDFDEVICE, ранее созданный драйвером клиента с помощью вызова WdfDeviceCreate.

[_In_opt_] ConfigurationAttributes

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

[_Out_] Configuration

Указатель на расположение, которое получает новый объект NETCONFIGURATION.

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

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

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

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

Требования

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

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

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

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