WDF_IO_QUEUE_STOPPED, fonction (wdfio.h)

Article
02/27/2024

[S’applique à KMDF et UMDF]

La fonction WDF_IO_QUEUE_STOPPED retourne TRUE si l’état d’une file d’attente d’E/S indique que la file d’attente est arrêtée.

Syntaxe

BOOLEAN WDF_IO_QUEUE_STOPPED(
  [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_STOPPED retourne TRUE si l’état de file d’attente spécifié indique que la file d’attente est arrêtée. Sinon, la fonction retourne FALSE.

Remarques

Une file d’attente d’E/S est arrêtée si elle peut accepter de nouvelles demandes d’E/S, mais que l’infrastructure ne les remet pas au pilote.

Votre pilote peut appeler WDF_IO_QUEUE_STOPPED 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 arrêtée.

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