KsMoveIrpsOnCancelableQueue, fonction (ks.h)
La fonction KsMoveIrpsOnCancelableQueue déplace les irps spécifiés du paramètre SourceList vers le paramètre DestinationList en fonction de la valeur renvoyée par la fonction KStrIrpListCallback définie par minidriver.
Syntaxe
KSDDKAPI NTSTATUS KsMoveIrpsOnCancelableQueue(
[in, out] PLIST_ENTRY SourceList,
[in] PKSPIN_LOCK SourceLock,
[in, out] PLIST_ENTRY DestinationList,
[in, optional] PKSPIN_LOCK DestinationLock,
[in] KSLIST_ENTRY_LOCATION ListLocation,
[in] PFNKSIRPLISTCALLBACK ListCallback,
[in] PVOID Context
);
Paramètres
[in, out] SourceList
Spécifie la tête de la file d’attente à partir de laquelle supprimer les IRP.
[in] SourceLock
Pointeur vers le verrou de rotation du pilote pour l’accès à la file d’attente source.
[in, out] DestinationList
Spécifie la tête de la file d’attente sur laquelle ajouter les IRPs.
[in, optional] DestinationLock
Contient éventuellement un pointeur vers le verrou de rotation du pilote pour l’accès à la file d’attente de destination. Si ce n’est pas fourni, le paramètre SourceLock est supposé contrôler les deux files d’attente. S’il est fourni, ce verrou est toujours acquis après le paramètre SourceLock . Si la liste de destination a un verrou de rotation distinct, le verrou de rotation d’annulation à l’échelle du système est d’abord acquis afin de déplacer les irps et de permettre la mise à jour du verrou de rotation KSQUEUE_SPINLOCK_IRP_STORAGE().
[in] ListLocation
Indique si les IRP doivent être énumérés à partir de la tête ou de la fin de la file d’attente source. Tous les IRP déplacés sont placés à l’extrémité opposée de la file d’attente de destination afin que l’ordre soit maintenu.
[in] ListCallback
Spécifie la fonction KStrIrpListCallback définie par minidriver à appeler pour indiquer si un IRP spécifique doit être déplacé de SourceList vers DestinationList ou si l’énumération doit être terminée.
[in] Context
Contexte passé à ListCallback.
Valeur retournée
Retourne STATUS_SUCCESS si la liste a été entièrement énumérée ; dans le cas contraire, retourne tout avertissement ou erreur retourné par la fonction de rappel KStrIrpListCallback définie par minidriver qui a interrompu l’énumération.
Remarques
Un IRP est déplacé si la fonction KStrIrpListCallback indique qu’il doit être déplacé, s’il est actuellement acquis. Si KStrIrpListCallback retourne STATUS_SUCCESS, l’IRP est déplacé. S’il retourne STATUS_NO_MATCH, l’IRP n’est pas déplacé. Toute autre valeur d’avertissement ou d’erreur de retour met fin à l’énumération et est retournée par la fonction. La valeur STATUS_NO_MATCH ne doit pas être retournée en tant qu’erreur par KStrIrpListCallback. KStrIrpListCallback est appelé au DISPATCH_LEVEL. KStrIrpListCallback est toujours appelé au moins une fois à la fin avec une valeur IRP NULL pour terminer l’énumération de liste.
KsMoveIrpsOnCancelableQueue continue dans la liste jusqu’à ce que la fonction de rappel indique que la recherche doit être terminée ou que la fin de la liste soit atteinte. KsMoveIrpsOnCancelableQueue réduit l’utilisation du verrou de rotation d’annulation à l’échelle du système en utilisant les verrous de rotation fournis pour synchroniser l’accès lorsque cela est possible. KsMoveIrpsOnCancelableQueue n’autorise pas la modification de la routine d’annulation lors du déplacement des IRPs.
La fonction peut être appelée à DISPATCH_LEVEL ou à une version inférieure.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | ks.h (inclure Ks.h) |
| Bibliothèque | Ks.lib |