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