fungsi WDF_IO_QUEUE_PURGED (wdfio.h)

Artikel
03/01/2024

[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;
}