Condividi tramite


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

Vedi anche

EVT_UCX_CONTROLLER_USBDEVICE_ADD