EVT_WDF_IO_QUEUE_STATE fonction de rappel (wdfio.h)

[S’applique à KMDF et UMDF]

La fonction de rappel d’événement EvtIoQueueState d’un pilote fournit des informations sur l’état de la file d’attente au pilote.

Syntaxe

EVT_WDF_IO_QUEUE_STATE EvtWdfIoQueueState;

void EvtWdfIoQueueState(
  [in] WDFQUEUE Queue,
  [in] WDFCONTEXT Context
)
{...}

Paramètres

[in] Queue

Handle pour un objet file d’attente d’E/S.

[in] Context

Informations de contexte définies par le pilote que le pilote a spécifiées lors de l’inscription de la fonction de rappel EvtIoQueueState .

Valeur de retour

None

Remarques

Les pilotes peuvent inscrire une fonction de rappel EvtIoQueueState en spécifiant son adresse en tant qu’entrée à WdfIoQueueStop, WdfIoQueueDrain, WdfIoQueuePurge ou WdfIoQueueReadyNotify. Le framework appelle la fonction de rappel EvtIoQueueState une fois l’opération spécifiée terminée.

La fonction de rappel EvtIoQueueState peut être appelée à l’adresse IRQL <= DISPATCH_LEVEL, sauf si le membre ExecutionLevel du WDF_OBJECT_ATTRIBUTES de la file d’attente est défini sur WdfExecutionLevelPassive, auquel cas elle est appelée dans IRQL = PASSIVE_LEVEL. Si la file d’attente spécifie WdfExecutionLevelInheritFromParent, la propriété peut être héritée de la WDF_OBJECT_ATTRIBUTES WDFDEVICE ou WDFDRIVER.

Si l’IRQL est PASSIVE_LEVEL, l’infrastructure appelle la fonction de rappel dans une région critique.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
Version UMDF minimale	2.0
En-tête	wdfio.h (inclure Wdf.h)
IRQL	<= DISPATCH_LEVEL (voir la section Notes)

Voir aussi

WDF_OBJECT_ATTRIBUTES

WdfIoQueueDrain

WdfIoQueuePurge

WdfIoQueueReadyNotify

WdfIoQueueStop