WDF_IO_QUEUE_PURGED, fonction (wdfio.h)

Article
02/27/2024

[S’applique à KMDF et UMDF]

La fonction WDF_IO_QUEUE_PURGED retourne TRUE si l’état d’une file d’attente d’E/S indique que la file d’attente est vidée.

Syntaxe

BOOLEAN WDF_IO_QUEUE_PURGED(
  [in] WDF_IO_QUEUE_STATE State
);

Paramètres

[in] State

Valeur de type WDF_IO_QUEUE_STATE que WdfIoQueueGetState retourne.

Valeur retournée

WDF_IO_QUEUE_PURGED retourne TRUE si l’état de file d’attente spécifié indique que la file d’attente est vidée. Sinon, la fonction retourne FALSE.

Remarques

Une file d’attente d’E/S est vidée si la file d’attente est vide et n’accepte pas de nouvelles demandes d’E/S, et si toutes les demandes qui se trouvaient dans la file d’attente ont été annulées.

Votre pilote peut appeler WDF_IO_QUEUE_PURGED après avoir appelé WdfIoQueueGetState.

Pour plus d’informations sur les états de file d’attente d’E/S, consultez WDF_IO_QUEUE_STATE.

Exemples

L’exemple de code suivant est une routine qui retourne TRUE si une file d’attente d’E/S spécifiée est vidée.

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