Función UcxUsbDeviceCreate (ucxusbdevice.h)
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 uno adecuado código de error NTSTATUS.
Observaciones
El controlador de cliente del 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 central primario especificado por UCX.
Para obtener un ejemplo de código, consulte EVT_UCX_CONTROLLER_USBDEVICE_ADD.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10 |
| de la plataforma de destino de | Windows |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | ucxusbdevice.h (include Ucxclass.h) |
| irQL | PASSIVE_LEVEL |