WDF_IO_QUEUE_PURGED函式 (wdfio.h)

發行項
02/27/2024

[適用於 KMDF 和 UMDF]

如果 I/O 佇列的狀態指出佇列已清空， 則WDF_IO_QUEUE_PURGED 函式會傳回 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;
}