KsSetPowerDispatch, fonction (ks.h)
Définit la fonction de répartition de l’alimentation à appeler lorsque l’objet pilote reçoit un IRP IRP_MJ_POWER . Cela n’est effectif que si KsDefaultDispatchPower est appelé pour distribuer ou terminer les irps d’alimentation.
Cela a pour effet d’ajouter cet en-tête d’objet à une liste d’en-têtes d’objets qui ont des routines de répartition de l’alimentation à exécuter. L’en-tête de cette liste est conservé par l’en-tête de l’appareil. Suppose que l’appelant a précédemment alloué un en-tête d’appareil sur l’objet device sous-jacent avec KsAllocateDeviceHeader.
Syntaxe
KSDDKAPI VOID KsSetPowerDispatch(
[in] KSOBJECT_HEADER Header,
[in, optional] PFNKSCONTEXT_DISPATCH PowerDispatch,
[in, optional] PVOID PowerContext
);
Paramètres
[in] Header
Pointe vers un en-tête précédemment alloué par KsAllocateObjectHeader.
[in, optional] PowerDispatch
Contient éventuellement la fonction de répartition de l’alimentation qui sera appelée, ou NULL si la fonction doit être supprimée de la liste des fonctions appelées. Cette fonction ne doit pas terminer l’IRP d’alimentation envoyée. La valeur de retour de cette fonction doit être STATUS_SUCCESS. KsSetPowerDispatch peut être appelé lors de l’exécution de cette routine de répartition de l’alimentation si l’objectif est de manipuler cette entrée de liste uniquement. La manipulation d’autres entrées de liste peut perturber l’énumération actuelle.
[in, optional] PowerContext
Contient éventuellement le paramètre de contexte à passer à la fonction de répartition de l’alimentation.
Valeur de retour
None
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | ks.h (inclure Ks.h) |
| Bibliothèque | Ks.lib |