WdfIoQueueStopSynchronously, fonction (wdfio.h)
[S’applique à KMDF et UMDF]
La méthode WdfIoQueueStopSynchronously empêche une file d’attente d’E/S de remettre des demandes d’E/S, mais la file d’attente reçoit et stocke les nouvelles demandes. La méthode retourne une fois que toutes les demandes remises ont été annulées ou terminées.
Syntaxe
void WdfIoQueueStopSynchronously(
[in] WDFQUEUE Queue
);
Paramètres
[in] Queue
Handle pour un objet de file d’attente d’infrastructure.
Valeur de retour
None
Remarques
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
La méthode WdfIoQueueStopSynchronously permet à la file d’attente de recevoir de nouvelles demandes, même si la file d’attente ne recevait pas de nouvelles demandes avant que le pilote appelé WdfIoQueueStopSynchronously ne soit reçu. Par exemple, un pilote peut appeler WdfIoQueueDrain, ce qui entraîne l’arrêt de l’ajout de nouvelles demandes d’E/S à la file d’attente. L’appel suivant du pilote WdfIoQueueStopSynchronously entraîne la reprise de l’ajout de requêtes à la file d’attente par le framework.
N’appelez pas WdfIoQueueStopSynchronously à partir des fonctions de rappel d’événement d’objet file d’attente suivantes, quelle que soit la file d’attente à laquelle la fonction de rappel d’événement est associée :
EvtIoDefaultEvtIoDeviceControlEvtIoInternalDeviceControlEvtIoReadEvtIoWrite Pour plus d’informations sur la méthode WdfIoQueueStopSynchronously , consultez Gestion des files d’attente d’E/S.
Exemples
L’exemple de code suivant arrête une file d’attente spécifiée.
WdfIoQueueStopSynchronously(WriteQueue);
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) |
| Bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| Règles de conformité DDI | ChangeQueueState(kmdf), DriverCreate(kmdf), EvtSurpriseRemoveNoSuspendQueue(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), NoCancelFromEvtSurpriseRemove(kmdf) |