Fungsi WdfIoQueuePurgeSynchronously (wdfio.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfIoQueuePurgeSynchronously menyebabkan kerangka kerja berhenti mengantre permintaan I/O ke antrean I/O dan membatalkan permintaan yang tidak diolah dan permintaan yang dapat dibatalkan milik driver.

Sintaks

void WdfIoQueuePurgeSynchronously(
  [in] WDFQUEUE Queue
);

Parameter

[in] Queue

Handel ke objek antrean kerangka kerja.

Nilai kembali

Tidak ada

Keterangan

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

Setelah driver memanggil WdfIoQueuePurgeSynchronously, kerangka kerja berhenti menambahkan permintaan I/O ke antrean yang ditentukan. Kerangka kerja membatalkan semua permintaan yang belum dikirimkan ke driver. Jika kerangka kerja menerima permintaan tambahan untuk antrean, kerangka kerja menyelesaikannya dengan nilai status penyelesaian STATUS_INVALID_DEVICE_STATE.

WdfIoQueuePurgeSynchronously kembali setelah semua permintaan yang tidak diolah dan dimiliki driver selesai atau dibatalkan.

Setelah driver menghapus antrean I/O, driver dapat memulai ulang antrean dengan memanggil WdfIoQueueStart.

Jangan panggil WdfIoQueuePurgeSynchronously dari fungsi panggilan balik peristiwa objek antrean berikut, terlepas dari antrean yang terkait dengan fungsi panggilan balik peristiwa:

EvtIoDefaultEvtIoDeviceControlEvtIoInternalDeviceControlEvtIoReadEvtIoWrite Untuk informasi selengkapnya tentang metode WdfIoQueuePurgeSynchronously , lihat Mengelola Antrean I/O.

Contoh

Contoh kode berikut menghapus menyeluruh antrean I/O tertentu.

WdfIoQueuePurgeSynchronously(ReadQueue);

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
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), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), NoCancelFromEvtSurpriseRemove(kmdf), NoIoQueuePurgeSynchronously(kmdf)

Lihat juga

WdfIoQueuePurge