Функция NetDeviceOpenConfiguration (netdevice.h)
Функция netDeviceOpenConfiguration открывает базу данных конфигурации net устройства.
Синтаксис
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 (include netadaptercx.h) |
| библиотеки | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |