WdfUsbTargetDeviceIsConnectedSynchronous, fonction (wdfusb.h)

  • Article

[S’applique uniquement à KMDF]

La méthode WdfUsbTargetDeviceIsConnectedSynchronous détermine si le périphérique USB spécifié est connecté.

Syntaxe

NTSTATUS WdfUsbTargetDeviceIsConnectedSynchronous(
  [in] WDFUSBDEVICE UsbDevice
);

Paramètres

[in] UsbDevice

Handle pour un objet de périphérique USB obtenu à partir d’un appel précédent à WdfUsbTargetDeviceCreateWithParameters.

Valeur retournée

WdfUsbTargetDeviceIsConnectedSynchronous retourne la valeur d’achèvement de la cible d’E/S status si l’opération réussit. Sinon, cette méthode peut retourner l’une des valeurs suivantes :

Code de retour Description
STATUS_INVALID_PARAMETER
 Un paramètre non valide a été détecté.
STATUS_INVALID_DEVICE_REQUEST
 L’IRQL de l’appelant n’était pas valide.
STATUS_DEVICE_NOT_CONNECTED ou STATUS_DEVICE_DOES_NOT_EXIST
 L’appareil n’était pas connecté.
 

Cette méthode peut également retourner d’autres valeurs NTSTATUS.

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

Pour plus d’informations sur la méthode WdfUsbTargetDeviceIsConnectedSynchronous et les cibles d’E/S USB, consultez Cibles d’E/S USB.

Exemples

L’exemple de code suivant détermine si un périphérique USB spécifié est connecté.

NTSTATUS status;

status = WdfUsbTargetDeviceIsConnectedSynchronous(UsbDevice);

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
En-tête wdfusb.h (inclure Wdfusb.h)
Bibliothèque Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.)
IRQL PASSIVE_LEVEL
Règles de conformité DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Voir aussi

WdfUsbTargetDeviceCreateWithParameters