WDF_IO_QUEUE_PURGED函式 （wdfio.h）
[適用於 KMDF 和 UMDF]
如果 I/O 佇列的狀態指出佇列已清空，WDF_IO_QUEUE_PURGED 函式會傳 回 TRUE。
語法
BOOLEAN WDF_IO_QUEUE_PURGED(
[in] WDF_IO_QUEUE_STATE State
);
參數
[in] State
WDF_IO_QUEUE_STATE-typed 值，WdfIoQueueGetState 傳回。
返回值
如果指定的佇列狀態指出佇列已清除，WDF_IO_QUEUE_PURGED 會傳 回 TRUE。 否則，函式會傳回 FALSE 。
備註
如果佇列是空的，且不接受新的 I/O 要求，以及佇列中的所有要求都已取消，則會清除 I/O 佇列。
您的驅動程式可以在呼叫 WdfIoQueueGetState之後呼叫 WDF_IO_QUEUE_PURGED。
如需 I/O 佇列狀態的詳細資訊，請參閱 WDF_IO_QUEUE_STATE。
範例
下列程式代碼範例是一個例程，會在清除指定的 I/O 佇列時傳回 TRUE。
BOOLEAN
IsQueuePurged(
IN WDFQUEUE Queue
)
{
WDF_IO_QUEUE_STATE queueStatus;
queueStatus = WdfIoQueueGetState(
Queue,
NULL,
NULL
);
return (WDF_IO_QUEUE_PURGED(queueStatus)) ? TRUE : FALSE;
}
需求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 標題 | wdfio.h （包括 Wdf.h） |
| 程式庫 | 沒有 |
| IRQL | 任何 IRQL。 |