共用方式為


WDF_IO_QUEUE_DRAINED函式 (wdfio.h)

[適用於 KMDF 和 UMDF]

如果 I/O 佇列的狀態指出佇列已清空, 則WDF_IO_QUEUE_DRAINED 函式會傳回 TRUE

語法

BOOLEAN WDF_IO_QUEUE_DRAINED(
  [in] WDF_IO_QUEUE_STATE State
);

參數

[in] State

WdfIoQueueGetState 傳回的WDF_IO_QUEUE_STATE型別值。

傳回值

如果 指定的佇列狀態指出佇列已清空,WDF_IO_QUEUE_DRAINED傳回 TRUE 。 否則,函式會傳回 FALSE

備註

如果 I/O 佇列不接受新的 I/O 要求,而且佇列中的所有要求都已傳遞至驅動程式,則會清空。

您的驅動程式可以在呼叫 WdfIoQueueGetState 之後呼叫WDF_IO_QUEUE_DRAINED

如需 I/O 佇列狀態的詳細資訊,請參閱 WDF_IO_QUEUE_STATE

範例

下列程式代碼範例是在清空指定的 I/O 佇列時傳回 TRUE 的例程。

BOOLEAN
IsQueueDrained(
    IN WDFQUEUE Queue
    )
{
    WDF_IO_QUEUE_STATE queueStatus;
    queueStatus = WdfIoQueueGetState(
                                     Queue,
                                     NULL,
                                     NULL
                                     );
    return (WDF_IO_QUEUE_DRAINED(queueStatus)) ? TRUE : FALSE;
}

規格需求

需求
目標平台 Universal
最小 KMDF 版本 1.0
標頭 wdfio.h (包含 Wdf.h)
程式庫
IRQL 任何 IRQL。

另請參閱

WDF_IO_QUEUE_IDLE

WDF_IO_QUEUE_PURGED

WDF_IO_QUEUE_READY

WDF_IO_QUEUE_STOPPED