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 I/O se l'operazione ha esito positivo. In caso contrario, questo metodo può restituire uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
|
È stato rilevato un parametro non valido. |
|
IRQL del chiamante non valido. |
|
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.
Osservazioni
Per altre informazioni sul metodo WdfUsbTargetDeviceIsConnectedSynchronous e sulle destinazioni di I/O USB, vedere Destinazioni I/O USB.
Esempi
L'esempio di codice seguente determina se un dispositivo USB specificato è connesso.
NTSTATUS status;
status = WdfUsbTargetDeviceIsConnectedSynchronous(UsbDevice);
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 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) |