Compartir a través de

Función UcxUsbDeviceCreate (ucxusbdevice.h)

  • Artículo

Crea un objeto de dispositivo USB en el controlador especificado.

Sintaxis

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

Parámetros

[in] Controller

Identificador del objeto de controlador. El controlador cliente recuperó el identificador en una llamada anterior a UcxControllerCreate.

[out] UsbDeviceInit

Puntero a una estructura de UCXUSBDEVICE_INIT que describe varias operaciones de configuración para crear el objeto de dispositivo USB. El controlador especifica punteros de función a sus funciones de devolución de llamada en esta estructura. Esta estructura se administra mediante UCX.

[in, optional] Attributes

Puntero a una estructura de WDF_OBJECT_ATTRIBUTES asignada por el autor de la llamada que especifica atributos para el objeto de dispositivo USB.

[out] UsbDevice

Puntero a una variable que recibe un identificador para el nuevo objeto de dispositivo USB.

Valor devuelto

El método devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, este método podría devolver un código de error NTSTATUS adecuado.

Comentarios

El controlador de cliente para el controlador de host debe llamar a este método después de la llamada WdfDeviceCreate . El elemento primario del nuevo objeto de dispositivo USB es el dispositivo concentrador primario especificado por UCX.

Para obtener un ejemplo de código, consulte EVT_UCX_CONTROLLER_USBDEVICE_ADD.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10
Plataforma de destino Windows
Versión mínima de KMDF 1.0
Versión mínima de UMDF 2.0
Encabezado ucxusbdevice.h (include Ucxclass.h)
IRQL PASSIVE_LEVEL

Consulte también

EVT_UCX_CONTROLLER_USBDEVICE_ADD