Funzione UcxUsbDeviceCreate (ucxusbdevice.h)
Crea un oggetto dispositivo USB nel controller specificato.
Sintassi
NTSTATUS UcxUsbDeviceCreate(
[in] UCXCONTROLLER Controller,
[out] PUCXUSBDEVICE_INIT *UsbDeviceInit,
[in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] UCXUSBDEVICE *UsbDevice
);
Parametri
[in] Controller
Handle per l'oggetto controller. Il driver client ha recuperato l'handle in una chiamata precedente a UcxControllerCreate.
[out] UsbDeviceInit
Puntatore a una struttura di UCXUSBDEVICE_INIT che descrive varie operazioni di configurazione per la creazione dell'oggetto dispositivo USB. Il driver specifica i puntatori di funzione alle relative funzioni di callback in questa struttura. Questa struttura è gestita da UCX.
[in, optional] Attributes
Puntatore a una struttura WDF_OBJECT_ATTRIBUTES allocata dal chiamante che specifica gli attributi per l'oggetto dispositivo USB.
[out] UsbDevice
Puntatore a una variabile che riceve un handle per il nuovo oggetto dispositivo USB.
Valore restituito
Il metodo restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo potrebbe restituire un codice di errore NTSTATUS appropriato.
Commenti
Il driver client per il controller host deve chiamare questo metodo dopo la chiamata WdfDeviceCreate . L'elemento padre del nuovo oggetto dispositivo USB è il dispositivo hub padre specificato da UCX.
Per un esempio di codice, vedere EVT_UCX_CONTROLLER_USBDEVICE_ADD.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10 |
| Piattaforma di destinazione | Windows |
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | ucxusbdevice.h (include Ucxclass.h) |
| IRQL | PASSIVE_LEVEL |