Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[S’applique à KMDF et UMDF]
La méthode WdfUsbTargetDeviceResetPortSynchronously réinitialise le port USB associé au périphérique USB spécifié.
Syntaxe
NTSTATUS WdfUsbTargetDeviceResetPortSynchronously(
[in] WDFUSBDEVICE UsbDevice
);
Paramètres
[in] UsbDevice
Handle vers un objet de périphérique USB obtenu à partir d’un appel précédent à WdfUsbTargetDeviceCreateWithParameters.
Valeur de retour
WdfUsbTargetDeviceResetPortSynchronously retourne la valeur d’état d’achèvement de la cible d’E/S USB si l’opération réussit. Sinon, cette méthode peut retourner l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
|
L’IRQL de l’appelant n’était pas valide. |
Cette méthode peut également retourner d’autres valeurs NTSTATUS .
Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.
Remarques
La méthode WdfUsbTargetDeviceResetPortSynchronous ly réinitialise le port USB en envoyant une requête IOCTL_INTERNAL_USB_RESET_PORT.
Avant que l’infrastructure réinitialise le port USB de la cible d’E/S, elle annule toutes les demandes d’E/S qui restent dans la file d’attente de la cible d’E/S. Le pilote ne doit pas envoyer de requêtes d’E/S supplémentaires à la cible d’E/S tant que WdfUsbTargetDeviceResetPortSynchronously retourne.
Le pilote doit appeler WdfIoTargetStop avant d’appeler WdfUsbTargetDeviceResetPortSynchronously. Après WdfUsbTargetDeviceResetPortSynchronously retourne, le pilote peut appeler WdfIoTargetStart.
Après une opération de réinitialisation réussie, le pilote de bus désélectionne la configuration et tous les autres paramètres d’interface que l’appareil avait avant l’opération de réinitialisation.
Pour plus d’informations sur la méthode WdfUsbTargetDeviceResetPortSynchronously et les cibles d’E/S USB, consultez cibles d’E/S USB.
Exemples
L’exemple de code suivant réinitialise le port USB d’un appareil spécifié.
NTSTATUS status;
status = WdfUsbTargetDeviceResetPortSynchronously(UsbDevice);
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| version minimale de UMDF | 2.0 |
| d’en-tête | wdfusb.h (include Wdfusb.h) |
| bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |