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) |