Функция 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.

Требования

См. также

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