fonction WDF_IO_QUEUE_DRAINED (wdfio.h)

Article
02/27/2024

[S’applique à KMDF et UMDF]

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

Syntaxe

BOOLEAN WDF_IO_QUEUE_DRAINED(
  [in] WDF_IO_QUEUE_STATE State
);

Paramètres

[in] State

Valeur de type WDF_IO_QUEUE_STATE retournée par WdfIoQueueGetState .

Valeur retournée

WDF_IO_QUEUE_DRAINED 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’E/S est vidée si elle n’accepte pas de nouvelles demandes d’E/S et si toutes les demandes qui se trouvaient dans la file d’attente ont été remises au pilote.

Votre pilote peut appeler WDF_IO_QUEUE_DRAINED 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’E/S spécifiée est vidée.

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