Функция NetDeviceOpenConfiguration (netdevice.h)
Функция 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.
Комментарии
Как правило, клиент вызывает эту функцию из функции обратного вызова EVT_WDF_DRIVER_DEVICE_ADD .
Если клиент предоставляет 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 |