Fungsi WdfUsbTargetDeviceIsConnectedSynchronous (wdfusb.h)

[Hanya berlaku untuk KMDF]

Metode WdfUsbTargetDeviceIsConnectedSynchronous menentukan apakah perangkat USB yang ditentukan tersambung.

Sintaks

NTSTATUS WdfUsbTargetDeviceIsConnectedSynchronous(
  [in] WDFUSBDEVICE UsbDevice
);

Parameter

[in] UsbDevice

Handel ke objek perangkat USB yang diperoleh dari panggilan sebelumnya ke WdfUsbTargetDeviceCreateWithParameters.

Nilai kembali

WdfUsbTargetDeviceIsConnectedSynchronous mengembalikan nilai status penyelesaian target I/O jika operasi berhasil. Jika tidak, metode ini dapat mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_INVALID_PARAMETER	Parameter yang tidak valid terdeteksi.
STATUS_INVALID_DEVICE_REQUEST	IRQL penelepon tidak valid.
STATUS_DEVICE_NOT_CONNECTED atau STATUS_DEVICE_DOES_NOT_EXIST	Perangkat tidak tersambung.

 

Metode ini juga dapat mengembalikan nilai NTSTATUS lainnya.

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Keterangan

Untuk informasi selengkapnya tentang metode WdfUsbTargetDeviceIsConnectedSynchronous dan target I/O USB, lihat Target I/O USB.

Contoh

Contoh kode berikut menentukan apakah perangkat USB tertentu tersambung.

NTSTATUS status;

status = WdfUsbTargetDeviceIsConnectedSynchronous(UsbDevice);

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Header	wdfusb.h (termasuk Wdfusb.h)
Pustaka	Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Lihat juga

WdfUsbTargetDeviceCreateWithParameters