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 efficace que si KsDefaultDispatchPower est appelé pour distribuer ou terminer des IRP d’alimentation.
Cela a pour effet d’ajouter cet en-tête d’objet à une liste d’en-têtes d’objet qui ont des routines de distribution d’alimentation à exécuter. La tête de cette liste est conservée 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 d’appareil 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 de puissance envoyée. La valeur de retour de cette fonction doit être STATUS_SUCCESS. KsSetPowerDispatch pouvez être appelée 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 confondre 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
Aucun
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |