WDF_IO_QUEUE_PURGED函数 （wdfio.h）
[适用于 KMDF 和 UMDF]
如果 I/O 队列的状态指示队列已清空，则 WDF_IO_QUEUE_PURGED 函数返回 true TRUE。
语法
BOOLEAN WDF_IO_QUEUE_PURGED(
[in] WDF_IO_QUEUE_STATE State
);
参数
[in] State
WdfIoQueueGetState 返回的 WDF_IO_QUEUE_STATE类型化值。
返回值
如果指定的队列状态指示队列已清除，则 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。 |