Функция UcxUsbDeviceCreate (ucxusbdevice.h)

Статья
02/07/2025

Создает объект USB-устройства на указанном контроллере.

Синтаксис

NTSTATUS UcxUsbDeviceCreate(
  [in]           UCXCONTROLLER          Controller,
  [out]          PUCXUSBDEVICE_INIT     *UsbDeviceInit,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          UCXUSBDEVICE           *UsbDevice
);

Параметры

[in] Controller

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

[out] UsbDeviceInit

Указатель на структуру UCXUSBDEVICE_INIT, описывающую различные операции конфигурации для создания объекта USB-устройства. Драйвер указывает указатель на функции обратного вызова в этой структуре. Эта структура управляется UCX.

[in, optional] Attributes

Указатель на выделенную вызывающим WDF_OBJECT_ATTRIBUTES структуру, указывающую атрибуты для объекта USB-устройства.

[out] UsbDevice

Указатель на переменную, которая получает дескриптор к новому объекту USB-устройства.

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

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

Замечания

Драйвер клиента для контроллера узла должен вызывать этот метод после вызова WdfDeviceCreate. Родительским объектом нового USB-устройства является родительское устройство, указанное UCX.

Пример кода см. в разделе EVT_UCX_CONTROLLER_USBDEVICE_ADD.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10
целевая платформа	Виндоус
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	ucxusbdevice.h (include Ucxclass.h)
IRQL	PASSIVE_LEVEL

См. также

EVT_UCX_CONTROLLER_USBDEVICE_ADD

Поделиться через