WdfIoQueueStopAndPurgeSynchronously, fonction (wdfio.h)
[S’applique à KMDF et UMDF]
La méthode WdfIoQueueStopAndPurgeSynchronously empêche une file d’attente d’E/S de remettre de nouvelles demandes d’E/S et provoque l’annulation des demandes non traitées existantes et des demandes annulables appartenant au pilote, mais la file d’attente reçoit et stocke les nouvelles demandes.
Syntaxe
void WdfIoQueueStopAndPurgeSynchronously(
[in] WDFQUEUE Queue
);
Paramètres
[in] Queue
Handle pour un objet de file d’attente d’infrastructure.
Valeur de retour
None
Remarques
Cette méthode retourne une fois que toutes les demandes non traitées et appartenant au pilote (sans compter les demandes ajoutées à la file d’attente après cet appel) sont terminées ou annulées. Si de nouvelles requêtes sont insérées alors que WdfIoQueueStopAndPurgeSynchronously est en cours, ces nouvelles demandes ne sont pas remises tant que le pilote n’a pas appelé WdfIoQueueStart.
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.11 |
| 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), NoCancelFromEvtSurpriseRemove(kmdf) |