WdfIoQueueStopSynchronously, fonction (wdfio.h)

  • Article

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

Voir aussi

WdfIoQueueStart

WdfIoQueueStop