Функция UcmInitializeDevice (ucmmanager.h)

  • Статья

Инициализирует расширение платформы диспетчера usb-соединителей (UcmCx).

Синтаксис

NTSTATUS UcmInitializeDevice(
  [in] WDFDEVICE           WdfDevice,
  [in] PUCM_MANAGER_CONFIG Config
);

Параметры

[in] WdfDevice

Дескриптор объекта устройства платформы, который драйвер клиента получил в предыдущем вызове WdfDeviceCreate.

[in] Config

Указатель на структуру UCM_MANAGER_CONFIG , предоставляемую вызывающим абонентом, которая инициализируется путем вызова UCM_MANAGER_CONFIG_INIT.

Возвращаемое значение

UcmInitializeDevice возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае этот метод может вернуть соответствующее значение NTSTATUS .

Комментарии

Этот метод инициализирует UcmCx и выделяет необходимые ресурсы, регистрирует события PnP и настраивает целевые объекты ввода-вывода. Драйвер клиента должен вызывать этот метод в реализации EVT_WDF_DRIVER_DEVICE_ADD драйвера.

Требования

Требование Значение
Минимальная версия клиента Windows 10
Минимальная версия сервера Windows Server 2016
Целевая платформа Windows
Минимальная версия KMDF 1.15
Минимальная версия UMDF 2.15
Верхняя часть ucmmanager.h (включая Ucmcx.h)
Библиотека UcmCxstub.lib
IRQL PASSIVE_LEVEL

См. также раздел

UCM_MANAGER_CONFIG

UCM_MANAGER_CONFIG_INIT