Funzione WdfUsbTargetDeviceIsConnectedSynchronous (wdfusb.h)

[Si applica solo a KMDF]

Il metodo WdfUsbTargetDeviceIsConnectedSynchronous determina se il dispositivo USB specificato è connesso.

Sintassi

NTSTATUS WdfUsbTargetDeviceIsConnectedSynchronous(
  [in] WDFUSBDEVICE UsbDevice
);

Parametri

[in] UsbDevice

Handle per un oggetto dispositivo USB ottenuto da una chiamata precedente a WdfUsbTargetDeviceCreateWithParameters.

Valore restituito

WdfUsbTargetDeviceIsConnectedSynchronous restituisce il valore di stato di completamento della destinazione di I/O se l'operazione ha esito positivo. In caso contrario, questo metodo può restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	È stato rilevato un parametro non valido.
STATUS_INVALID_DEVICE_REQUEST	IrQL del chiamante non valido.
STATUS_DEVICE_NOT_CONNECTED o STATUS_DEVICE_DOES_NOT_EXIST	Il dispositivo non è stato connesso.

 

Questo metodo potrebbe anche restituire altri valori NTSTATUS.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Commenti

Per altre informazioni sul metodo WdfUsbTargetDeviceIsConnectedSynchronous e sulle destinazioni di I/O USB, vedere Destinazioni di I/O USB.

Esempio

L'esempio di codice seguente determina se un dispositivo USB specificato è connesso.

NTSTATUS status;

status = WdfUsbTargetDeviceIsConnectedSynchronous(UsbDevice);

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Intestazione	wdfusb.h (include Wdfusb.h)
Libreria	Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Vedi anche

WdfUsbTargetDeviceCreateWithParameters