Fungsi WdfIoQueueStopSynchronously (wdfio.h)
[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) |