fonction WDF_IO_QUEUE_READY (wdfio.h)

2025-03-22

[S’applique à KMDF et UMDF]

La fonction WDF_IO_QUEUE_READY 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_READY(
  [in] WDF_IO_QUEUE_STATE State
);

Paramètres

[in] State

Valeur WDF_IO_QUEUE_STATE-typée qui WdfIoQueueGetState retourne.

Valeur de retour

WDF_IO_QUEUE_READY retourne TRUE si l’état de file d’attente spécifié indique que la file d’attente est prête. Sinon, la fonction retourne faux.

Remarques

Une file d’attente d’E/S est prête si la file d’attente peut accepter et distribuer des demandes d’E/S.

Votre pilote peut appeler WDF_IO_QUEUE_READY une fois qu’il a 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 prête.

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