Fungsi WdfIoQueueStopAndPurgeSynchronously (wdfio.h)

[Berlaku untuk KMDF dan UMDF]

Metode WdfIoQueueStopAndPurgeSynchronously mencegah antrean I/O mengirimkan permintaan I/O baru dan menyebabkan kerangka kerja membatalkan permintaan yang tidak diolah dan permintaan yang dapat dibatalkan milik driver yang ada, tetapi antrean menerima dan menyimpan permintaan baru.

Sintaks

void WdfIoQueueStopAndPurgeSynchronously(
  [in] WDFQUEUE Queue
);

Parameter

[in] Queue

Handel ke objek antrean kerangka kerja.

Nilai kembali

Tidak ada

Keterangan

Metode ini kembali setelah semua permintaan yang tidak diolah dan dimiliki driver (tidak termasuk permintaan yang ditambahkan ke antrean setelah panggilan ini dilakukan) selesai atau dibatalkan. Jika permintaan baru dimasukkan saat WdfIoQueueStopAndPurgeSynchronously sedang berlangsung, permintaan baru ini tidak dikirimkan sampai driver memanggil WdfIoQueueStart.

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1.11
Versi UMDF minimum 2.0
Header wdfio.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI ChangeQueueState(kmdf), DriverCreate(kmdf), EvtSurpriseRemoveNoSuspendQueue(kmdf), NoCancelFromEvtSurpriseRemove(kmdf)

Lihat juga

WdfIoQueueStopAndPurge