Bagikan melalui


IWDFIoQueue::Metode stop (wudfddi.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.]

Metode Hentikan mencegah antrean I/O mengirimkan permintaan I/O, tetapi antrean menerima dan menyimpan permintaan baru.

Sintaks

void Stop(
  [in, optional] IQueueCallbackStateChange *pStopComplete
);

Parameter

[in, optional] pStopComplete

Penunjuk ke antarmuka IQueueCallbackStateChange yang metodenya dipanggil kerangka kerja setelah semua permintaan I/O yang luar biasa, jika ada, di driver selesai. Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

Tidak ada

Keterangan

Panggilan ke Berhenti tidak sinkron dan segera kembali ke driver. Driver diberi tahu melalui metode antarmuka IQueueCallbackStateChange yang disediakan setelah semua permintaan yang luar biasa dalam driver selesai.

Driver harus memastikan bahwa hanya salah satu metode berikut yang sedang berlangsung pada waktu tertentu:

Misalnya, jika driver sebelumnya disebut Berhenti, itu harus menunggu pemberitahuan dari metode antarmuka yang ditunjukkan parameter pStopComplete sebelum driver memanggil Pengurasan atau Hapus Menyeluruh. Melanggar aturan ini menghasilkan penghentian proses host.

Metode Hentikan memungkinkan antrean untuk menerima permintaan baru, bahkan jika antrean tidak menerima permintaan baru sebelum driver yang disebut Berhenti. Misalnya, driver mungkin memanggil IWDFIoQueue::D rain, yang menyebabkan kerangka kerja berhenti menambahkan permintaan I/O baru ke antrean. Panggilan Stop driver berikutnya menyebabkan kerangka kerja melanjutkan penambahan permintaan ke antrean.

Persyaratan

Persyaratan Nilai
Akhir dukungan Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform Desktop
Versi UMDF minimum 1,5
Header wudfddi.h (termasuk Wudfddi.h)
DLL WUDFx.dll

Lihat juga

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::D rain

IWDFIoQueue::P urge