fungsi WDF_IO_QUEUE_PURGED (wdfio.h)
[Berlaku untuk KMDF dan UMDF]
Fungsi WDF_IO_QUEUE_PURGED mengembalikan TRUE jika status antrean I/O menunjukkan bahwa antrean dikosongkan.
Sintaks
BOOLEAN WDF_IO_QUEUE_PURGED(
[in] WDF_IO_QUEUE_STATE State
);
Parameter
[in] State
Nilai WDF_IO_QUEUE_STATE-ketik yang dikembalikan WdfIoQueueGetState .
Nilai kembali
WDF_IO_QUEUE_PURGED mengembalikan TRUE jika status antrean yang ditentukan menunjukkan bahwa antrean dihapus menyeluruh. Jika tidak, fungsi mengembalikan FALSE.
Keterangan
Antrean I/O dihapus menyeluruh jika antrean kosong dan tidak menerima permintaan I/O baru, dan jika semua permintaan yang berada dalam antrean telah dibatalkan.
Driver Anda dapat memanggil WDF_IO_QUEUE_PURGED setelah disebut WdfIoQueueGetState.
Untuk informasi selengkapnya tentang status antrean I/O, lihat WDF_IO_QUEUE_STATE.
Contoh
Contoh kode berikut adalah rutinitas yang mengembalikan TRUE jika antrean I/O tertentu dihapus menyeluruh.
BOOLEAN
IsQueuePurged(
IN WDFQUEUE Queue
)
{
WDF_IO_QUEUE_STATE queueStatus;
queueStatus = WdfIoQueueGetState(
Queue,
NULL,
NULL
);
return (WDF_IO_QUEUE_PURGED(queueStatus)) ? TRUE : FALSE;
}
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Versi KMDF minimum | 1,0 |
Header | wdfio.h (termasuk Wdf.h) |
Pustaka | Tidak ada |
IRQL | Setiap IRQL. |