WdfUsbTargetDeviceIsConnectedSynchronous-Funktion (wdfusb.h)
[Gilt nur für KMDF]
Die WdfUsbTargetDeviceIsConnectedSynchronous-Methode bestimmt, ob das angegebene USB-Gerät angeschlossen ist.
NTSTATUS WdfUsbTargetDeviceIsConnectedSynchronous(
[in] WDFUSBDEVICE UsbDevice
);
[in] UsbDevice
Ein Handle für ein USB-Geräteobjekt, das aus einem vorherigen Aufruf von WdfUsbTargetDeviceCreateWithParameters abgerufen wurde.
WdfUsbTargetDeviceIsConnectedSynchronous gibt den Abschluss des E/A-Ziels status Wert zurück, wenn der Vorgang erfolgreich ist. Andernfalls kann diese Methode einen der folgenden Werte zurückgeben:
Rückgabecode | Beschreibung |
---|---|
|
Ein ungültiger Parameter wurde erkannt. |
|
Die IRQL des Aufrufers war ungültig. |
|
Das Gerät war nicht verbunden. |
Diese Methode kann auch andere NTSTATUS-Werte zurückgeben.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Weitere Informationen zur WdfUsbTargetDeviceIsConnectedSynchronous-Methode und USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.
Im folgenden Codebeispiel wird ermittelt, ob ein angegebenes USB-Gerät angeschlossen ist.
NTSTATUS status;
status = WdfUsbTargetDeviceIsConnectedSynchronous(UsbDevice);
Anforderung | Wert |
---|---|
Zielplattform | Universell |
KMDF-Mindestversion | 1.0 |
Kopfzeile | wdfusb.h (wdfusb.h einschließen) |
Bibliothek | Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).) |
IRQL | PASSIVE_LEVEL |
DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |