WDF_IO_QUEUE_DRAINED-Funktion (wdfio.h)

[Gilt für KMDF und UMDF]

Die funktion WDF_IO_QUEUE_DRAINED gibt TRUE zurück, wenn der Status der E/A-Warteschlange angibt, dass die Warteschlange abgelassen wird.

Syntax

BOOLEAN WDF_IO_QUEUE_DRAINED(
  [in] WDF_IO_QUEUE_STATE State
);

Die Parameter

[in] State

Ein WDF_IO_QUEUE_STATE-typed-Wert, der WdfIoQueueGetState zurückgibt.

Rückgabewert

WDF_IO_QUEUE_DRAINED gibt TRUE- zurück, wenn der angegebene Warteschlangenstatus angibt, dass die Warteschlange abgelassen wird. Andernfalls gibt die Funktion FALSEzurück.

Bemerkungen

Eine E/A-Warteschlange wird ausgelassen, wenn sie keine neuen E/A-Anforderungen akzeptiert und alle Anforderungen, die sich in der Warteschlange befanden, an den Treiber übermittelt wurden.

Ihr Treiber kann WDF_IO_QUEUE_DRAINED aufrufen, nachdem er WdfIoQueueGetStateaufgerufen hat.

Weitere Informationen zu E/A-Warteschlangenzuständen finden Sie unter WDF_IO_QUEUE_STATE.

Beispiele

Das folgende Codebeispiel ist eine Routine, die TRUE- zurückgibt, wenn eine angegebene E/A-Warteschlange entwässert wird.

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

Anforderungen

Siehe auch

WDF_IO_QUEUE_IDLE

WDF_IO_QUEUE_PURGED

WDF_IO_QUEUE_READY

WDF_IO_QUEUE_STOPPED