Fungsi WdfIoQueueStopSynchronously (wdfio.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfIoQueueStopSynchronously mencegah antrean I/O mengirimkan permintaan I/O, tetapi antrean menerima dan menyimpan permintaan baru. Metode ini kembali setelah semua permintaan yang dikirim telah dibatalkan atau diselesaikan.

Sintaks

void WdfIoQueueStopSynchronously(
  [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.

Metode WdfIoQueueStopSynchronously memungkinkan antrean untuk menerima permintaan baru, bahkan jika antrean tidak menerima permintaan baru sebelum driver yang disebut WdfIoQueueStopSynchronously. Misalnya, driver mungkin memanggil WdfIoQueueDrain, yang menyebabkan kerangka kerja berhenti menambahkan permintaan I/O baru ke antrean. Panggilan berikutnya dari driver WdfIoQueueStopSynchronously menyebabkan kerangka kerja melanjutkan penambahan permintaan ke antrean.

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

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

Contoh

Contoh kode berikut menghentikan antrean tertentu.

WdfIoQueueStopSynchronously(WriteQueue);

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)

Lihat juga

WdfIoQueueStart

WdfIoQueueStop