Fungsi WdfUsbTargetDeviceIsConnectedSynchronous (wdfusb.h)

  • Artikel

[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