Partager via


UcxUsbDeviceCreate, fonction (ucxusbdevice.h)

Crée un objet de périphérique 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 diverses opérations de configuration pour la création de l’objet périphérique USB. Le pilote spécifie des 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 de 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 périphérique USB.

Valeur retournée

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

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 le périphérique hub parent spécifié par UCX.

Pour obtenir un exemple de code, consultez EVT_UCX_CONTROLLER_USBDEVICE_ADD.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10
Plateforme cible Windows
Version KMDF minimale 1.0
Version UMDF minimale 2.0
En-tête ucxusbdevice.h (inclure Ucxclass.h)
IRQL PASSIVE_LEVEL

Voir aussi

EVT_UCX_CONTROLLER_USBDEVICE_ADD