Metode IUsbTargetPipeContinuousReaderCallbackReadersFailed::OnReaderFailure (wudfusb.h)
[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]
Fungsi panggilan balik peristiwa OnReaderFailure driver memberi tahu driver bahwa pembaca berkelanjutan telah melaporkan kesalahan saat memproses permintaan baca.
Sintaks
BOOL OnReaderFailure(
[in] IWDFUsbTargetPipe *pPipe,
[in] HRESULT hrStatus
);
Parameter
[in] pPipe
Penunjuk ke antarmuka IWDFUsbTargetPipe untuk pipa USB tempat driver telah mengaktifkan pembaca berkelanjutan.
[in] hrStatus
Nilai status jenis HRESULT yang dikembalikan target I/O pipa USB.
Nilai kembali
Fungsi panggilan balik peristiwa OnReaderFailure harus mengembalikan nilai Boolean. Jika nilai yang dikembalikan TRUE, kerangka kerja mengatur ulang pipa USB lalu memulai ulang pembaca berkelanjutan. Jika fungsi panggilan balik mengembalikan FALSE, kerangka kerja tidak mengatur ulang perangkat atau memulai ulang pembaca berkelanjutan.
Keterangan
Untuk mendaftarkan fungsi panggilan balik OnReaderFailure , driver Anda harus menyediakan penunjuk ke antarmuka IUsbTargetPipeContinuousReaderCallbackReadersFailed driver saat memanggil antarmuka IWDFUsbTargetPipe2::ConfigureContinuousReader.
Jika driver telah membuat pembaca berkelanjutan untuk pipa USB, kerangka kerja memanggil fungsi panggilan balik OnReaderFailure driver jika target I/O driver melaporkan kesalahan saat menyelesaikan permintaan baca. (Jika target I/O berhasil menyelesaikan permintaan, kerangka kerja memanggil fungsi panggilan balik IUsbTargetPipeContinuousReaderCallbackReadComplete::OnReaderCompletion driver.)
Sebelum kerangka kerja memanggil fungsi panggilan balik OnReaderFailure driver, kerangka kerja mencoba membatalkan semua permintaan baca yang sedang berlangsung. Tidak ada permintaan baca yang sedang berlangsung ketika kerangka kerja memanggil fungsi panggilan balik OnReaderFailure . Kerangka kerja tidak mengantre permintaan baca tambahan hingga fungsi panggilan balik OnReaderFailure kembali.
Untuk informasi tentang bagaimana kerangka kerja menyinkronkan panggilan ke fungsi panggilan balik OnReaderFailure dengan panggilan ke fungsi panggilan balik lainnya, lihat bagian Keterangan dari IUsbTargetPipeContinuousReaderCallbackReadComplete::OnReaderCompletion.
Fungsi panggilan balik OnReaderFailure tidak boleh memanggil IWDFIoTargetStateManagement::Stop untuk menghentikan target USB pembaca berkelanjutan. (Bahkan, memanggil IWDFIoTargetStateManagement::Stop dalam fungsi panggilan balik OnReaderFailure menyebabkan kebuntuan.) Selain itu, fungsi panggilan balik tidak boleh memanggil IWDFIoTargetStateManagement::Start untuk memulai ulang pembaca berkelanjutan. Sebaliknya, kerangka kerja memulai ulang pembaca jika fungsi panggilan balik mengembalikan TRUE. Untuk informasi selengkapnya tentang kapan harus memanggil IWDFIoTargetStateManagement::Start dan IWDFIoTargetStateManagement::Stop untuk pembaca berkelanjutan, lihat Bekerja dengan Pipa USB di UMDF.
Jika driver tidak menyediakan fungsi panggilan balik OnReaderFailure dan target I/O driver melaporkan kesalahan, kerangka kerja mengatur ulang pipa USB dan memulai ulang pembaca berkelanjutan.
Untuk informasi selengkapnya tentang fungsi panggilan balik OnReaderFailure dan target I/O USB, lihat Menangani Target I/O USB.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Akhir dukungan | Tidak tersedia di UMDF 2.0 dan yang lebih baru. |
| Target Platform | Desktop |
| Versi UMDF minimum | 1.9 |
| Header | wudfusb.h (termasuk Wudfusb.h) |
Lihat juga
IUsbTargetPipeContinuousReaderCallbackReadComplete::OnReaderCompletion