Fungsi WdfUsbTargetDeviceResetPortSynchronously (wdfusb.h)

  • Artikel

[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
STATUS_INVALID_DEVICE_REQUEST
 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)

Lihat juga

WdfUsbTargetDeviceCreateWithParameters