WDF_IO_QUEUE_PURGED-Funktion (wdfio.h)

Artikel
02/27/2024

[Gilt für KMDF und UMDF]

Die WDF_IO_QUEUE_PURGED-Funktion gibt TRUE zurück, wenn der Status einer E/A-Warteschlange angibt, dass die Warteschlange leer ist.

Syntax

BOOLEAN WDF_IO_QUEUE_PURGED(
  [in] WDF_IO_QUEUE_STATE State
);

Parameter

[in] State

Ein WDF_IO_QUEUE_STATE typisierter Wert, den WdfIoQueueGetState zurückgibt.

Rückgabewert

WDF_IO_QUEUE_PURGED gibt TRUE zurück, wenn der angegebene Warteschlangenzustand angibt, dass die Warteschlange gelöscht wurde. Andernfalls gibt die Funktion FALSE zurück.

Hinweise

Eine E/A-Warteschlange wird gelöscht, wenn die Warteschlange leer ist und keine neuen E/A-Anforderungen akzeptiert, und wenn alle Anforderungen, die sich in der Warteschlange befanden, abgebrochen wurden.

Ihr Treiber kann WDF_IO_QUEUE_PURGED aufrufen, nachdem er WdfIoQueueGetState aufgerufen 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 gelöscht wird.

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