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