Bagikan melalui

Fungsi WdfUsbTargetDeviceCyclePortSynchronously (wdfusb.h)

  • Artikel

[Hanya berlaku untuk KMDF]

Metode WdfUsbTargetDeviceCyclePortSynchronously melakukan siklus daya pada port USB tempat perangkat tertentu terpasang.

Sintaks

NTSTATUS WdfUsbTargetDeviceCyclePortSynchronously(
  [in] WDFUSBDEVICE UsbDevice
);

Parameter

[in] UsbDevice

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

Nilai kembali

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

Menampilkan kode Deskripsi
STATUS_INVALID_DEVICE_REQUEST
 IRQL penelepon tidak valid.
 

Metode ini juga dapat mengembalikan nilai NTSTATUS lainnya.

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

Keterangan

Bersepeda daya port menyebabkan perangkat dihapus dan dijumlahkan kembali. Driver mungkin meminta siklus daya setelah memuat firmware ke dalam perangkat.

Sebelum kerangka kerja memutar port USB target I/O, kerangka kerja membatalkan semua permintaan I/O yang tetap berada dalam antrean target I/O. Driver tidak boleh mengirim permintaan I/O tambahan ke target I/O hingga WdfUsbTargetDeviceCyclePortSynchronously kembali.

Driver harus memanggil WdfIoTargetStop sebelum memanggil WdfUsbTargetDeviceCyclePortSynchronously.

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

Contoh

Contoh kode berikut menyikutkan daya port USB perangkat tertentu.

NTSTATUS status;

status = WdfUsbTargetDeviceCyclePortSynchronously(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