UcxUsbDeviceCreate, fonction (ucxusbdevice.h)

Crée un objet d’appareil USB sur le contrôleur spécifié.

Syntaxe

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

Paramètres

[in] Controller

Handle de l’objet contrôleur. Le pilote client a récupéré le handle dans un appel précédent à UcxControllerCreate.

[out] UsbDeviceInit

Pointeur vers une structure UCXUSBDEVICE_INIT qui décrit différentes opérations de configuration pour la création de l’objet périphérique USB. Le pilote spécifie les pointeurs de fonction vers ses fonctions de rappel dans cette structure. Cette structure est gérée par UCX.

[in, optional] Attributes

Pointeur vers une structure WDF_OBJECT_ATTRIBUTES allouée par l’appelant qui spécifie des attributs pour l’objet périphérique USB.

[out] UsbDevice

Pointeur vers une variable qui reçoit un handle vers le nouvel objet de périphérique USB.

Valeur de retour

La méthode retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette méthode peut retourner une appropriée code d’erreur NTSTATUS.

Remarques

Le pilote client du contrôleur hôte doit appeler cette méthode après l’appel WdfDeviceCreate. Le parent du nouvel objet de périphérique USB est l’appareil hub parent spécifié par UCX.

Pour obtenir un exemple de code, consultez EVT_UCX_CONTROLLER_USBDEVICE_ADD.

Exigences

Voir aussi

EVT_UCX_CONTROLLER_USBDEVICE_ADD