Bagikan melalui

Metode IWDFIoQueue::D rain (wudfddi.h)

  • Artikel

[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 Pengurasan mengarahkan antrean untuk menolak permintaan I/O masuk baru dan memungkinkan permintaan yang sudah diantrekan dikirimkan ke driver untuk diproses.

Sintaks

void Drain(
  [in, optional] IQueueCallbackStateChange *pDrainComplete
);

Parameter

[in, optional] pDrainComplete

Penunjuk ke antarmuka IQueueCallbackStateChange yang metodenya dipanggil kerangka kerja untuk mengirimkan status antrean ke driver. Kerangka kerja memanggil metode setelah semua permintaan selesai atau dibatalkan dan antrean kosong. Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

Tidak ada

Keterangan

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

Misalnya, jika driver sebelumnya disebut Drain, itu harus menunggu pemberitahuan dari metode antarmuka yang ditunjukkan oleh parameter pDrainComplete sebelum driver memanggil Stop atau Purge. Melanggar aturan ini menghasilkan penghentian proses host.

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::P urge

IWDFIoQueue::Stop