Fungsi WdfUsbTargetDeviceResetPortSynchronously (wdfusb.h)
[Berlaku untuk KMDF dan UMDF]
Metode WdfUsbTargetDeviceResetPortSynchronously mengatur ulang port USB yang terkait dengan perangkat USB yang ditentukan.
Sintaks
NTSTATUS WdfUsbTargetDeviceResetPortSynchronously(
[in] WDFUSBDEVICE UsbDevice
);
Parameter
[in] UsbDevice
Handel ke objek perangkat USB yang diperoleh dari panggilan sebelumnya ke WdfUsbTargetDeviceCreateWithParameters.
Nilai kembali
WdfUsbTargetDeviceResetPortSynchronously mengembalikan nilai status penyelesaian target USB I/O jika operasi berhasil. Jika tidak, metode ini dapat mengembalikan salah satu nilai berikut:
| Menampilkan kode | Deskripsi |
|---|---|
|
IRQL penelepon tidak valid. |
Metode ini juga mungkin mengembalikan nilai NTSTATUS lainnya.
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Keterangan
Metode WdfUsbTargetDeviceResetPortSynchronously mengatur ulang port USB dengan mengirim permintaan IOCTL_INTERNAL_USB_RESET_PORT .
Sebelum kerangka kerja mengatur ulang 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 WdfUsbTargetDeviceResetPortSynchronously kembali.
Driver harus memanggil WdfIoTargetStop sebelum memanggil WdfUsbTargetDeviceResetPortSynchronously. Setelah WdfUsbTargetDeviceResetPortSynchronously kembali, driver dapat memanggil WdfIoTargetStart.
Setelah operasi reset berhasil, driver bus memilih kembali konfigurasi dan pengaturan antarmuka alternatif apa pun yang dimiliki perangkat sebelum operasi reset terjadi.
Untuk informasi selengkapnya tentang metode WdfUsbTargetDeviceResetPortSynchronously dan target I/O USB, lihat Target I/O USB.
Contoh
Contoh kode berikut mereset port USB perangkat tertentu.
NTSTATUS status;
status = WdfUsbTargetDeviceResetPortSynchronously(UsbDevice);
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1,0 |
| Versi UMDF minimum | 2.0 |
| Header | wdfusb.h (termasuk Wdfusb.h) |
| Pustaka | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| Aturan kepatuhan DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |