EVT_WDF_IO_QUEUE_IO_DEFAULT fonction de rappel (wdfio.h)
[S’applique à KMDF et UMDF]
La fonction de rappel d’événement EvtIoDefault d’un pilote traite une demande d’E/S spécifiée.
Syntaxe
EVT_WDF_IO_QUEUE_IO_DEFAULT EvtWdfIoQueueIoDefault;
void EvtWdfIoQueueIoDefault(
[in] WDFQUEUE Queue,
[in] WDFREQUEST Request
)
{...}
Paramètres
[in] Queue
Handle de l’objet de file d’attente d’infrastructure associé à la demande d’E/S.
[in] Request
Handle d’un objet de requête d’infrastructure.
Valeur de retour
None
Remarques
Un pilote inscrit une fonction de rappel EvtIoDefault lorsqu’il appelle WdfIoQueueCreate. Pour plus d’informations sur l’appel de WdfIoQueueCreate, consultez Création de files d’attente d’E/S.
Si un pilote a inscrit une fonction de rappel EvtIoDefault pour la file d’attente d’E/S d’un appareil, la fonction de rappel reçoit chaque demande d’E/S de la file d’attente, sauf si des fonctions de rappel spécifiques à la demande ont également été inscrites. Pour plus d’informations sur les fonctions de rappel spécifiques aux requêtes, consultez Gestionnaires de demandes.
La fonction de rappel EvtIoDefault d’un pilote peut également recevoir des demandes de création de fichiers. Pour plus d’informations sur la réception des demandes de création de fichiers, consultez Framework File Objects.
La fonction de rappel EvtIoDefault doit traiter chaque demande d’E/S reçue d’une manière ou d’une autre. Pour plus d’informations, consultez Traitement des demandes d’E/S.
La plupart des opérations d’E/S nécessitent une mémoire tampon d’entrée, une mémoire tampon de sortie ou les deux. Pour plus d’informations sur la façon dont le pilote peut accéder aux mémoires tampons d’une requête, consultez Accès aux mémoires tampons de données dans les pilotes Framework-Based.
Cette fonction de rappel peut être appelée dans IRQL <= DISPATCH_LEVEL, sauf si le membre ExecutionLevel de la structure de WDF_OBJECT_ATTRIBUTES de l’appareil ou du pilote est défini sur WdfExecutionLevelPassive.
Si l’IRQL est PASSIVE_LEVEL, l’infrastructure appelle la fonction de rappel dans une région critique.
Pour plus d’informations sur les niveaux IRQL pour les gestionnaires de requêtes, consultez Utilisation de la synchronisation automatique.
La fonction de rappel EvtIoDefault d’un pilote ne doit pas appeler les méthodes d’objet file d’attente suivantes :
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 Remarques) |