Metode IQueueCallbackIoStop::OnIoStop (wudfddi.h)

Artikel
02/27/2024

[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 OnIoStop menghentikan pemrosesan permintaan I/O yang ditentukan dari antrean yang ditentukan.

Sintaks

void OnIoStop(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] ULONG         ActionFlags
);

Parameter

[in] pWdfQueue

Penunjuk ke antarmuka IWDFIoQueue untuk objek antrean I/O tempat pemrosesan permintaan I/O dihentikan.

[in] pWdfRequest

Penunjuk ke antarmuka IWDFIoRequest yang mewakili objek permintaan kerangka kerja yang pemrosesannya dihentikan.

[in] ActionFlags

Bitwise YANG valid ATAU dari nilai WDF_REQUEST_STOP_ACTION_FLAGS-typed yang mengidentifikasi status permintaan tindakan berhenti.

Nilai kembali

Tidak ada

Keterangan

Driver mendaftarkan antarmuka IQueueCallbackIoStop saat driver memanggil metode IWDFDevice::CreateIoQueue untuk membuat antrean I/O atau untuk mengonfigurasi antrean I/O default.

Jika driver mendaftarkan fungsi panggilan balik OnIoStop untuk antrean I/O, kerangka kerja memanggilnya ketika perangkat yang mendasar antrean meninggalkan status berfungsi (D0). Kerangka kerja memanggil fungsi panggilan balik OnIoStop untuk setiap permintaan I/O yang belum diselesaikan driver, termasuk permintaan yang dimiliki driver dan yang telah diteruskan ke target I/O.

Fungsi panggilan balik OnIoStop harus menyelesaikan, membatalkan, atau menunda pemrosesan permintaan I/O lebih lanjut. Anda harus menggunakan aturan berikut:

Jika driver memiliki permintaan I/O, driver harus memanggil IWDFIoRequest::Complete untuk menyelesaikan atau membatalkan permintaan, atau harus menunda pemrosesan permintaan lebih lanjut dan kemudian memanggil IWDFIoRequest2::StopAcknowledge.

Jika driver telah meneruskan permintaan I/O ke target I/O, driver harus memanggil IWDFIoRequest::CancelSentRequest untuk mencoba membatalkan permintaan, atau harus menunda pemrosesan permintaan lebih lanjut dan kemudian memanggil StopAcknowledge.

Jika bendera WdfRequestStopRequestCancelable diatur dalam parameter ActionFlags , driver harus memanggil IWDFIoRequest::UnmarkCancelable sebelum memanggil IWDFIoRequest::Complete untuk menyelesaikan (atau membatalkan) permintaan atau memanggil IWDFIoRequest2::StopAcknowledge untuk mengantre ulang permintaan.