KsSetPowerDispatch-Funktion (ks.h)

Artikel
02/07/2025

Legt fest, dass die Power Dispatch-Funktion aufgerufen wird, wenn das Treiberobjekt eine IRP_MJ_POWER IRP empfängt. Dies ist nur wirksam, wenn KsDefaultDispatchPower aufgerufen wird, um Energie-IRPs zu verteilen oder abzuschließen.

Dadurch wird dieser Objektheader einer Liste von Objektkopfzeilen hinzugefügt, die über auszuführende Power Dispatch-Routinen verfügen. Der Kopf dieser Liste wird vom Gerätekopf beibehalten. Es wird davon ausgegangen, dass der Aufrufer zuvor einen Geräteheader für das zugrunde liegende Device Object mit KsAllocateDeviceHeaderzugewiesen hat.

Syntax

KSDDKAPI VOID KsSetPowerDispatch(
  [in]           KSOBJECT_HEADER       Header,
  [in, optional] PFNKSCONTEXT_DISPATCH PowerDispatch,
  [in, optional] PVOID                 PowerContext
);

Parameter

[in] Header

Verweist auf eine Kopfzeile, die zuvor von KsAllocateObjectHeaderzugewiesen wurde.

[in, optional] PowerDispatch

Enthält optional die Power Dispatch-Funktion, die aufgerufen wird, oder NULL-, wenn die Funktion aus der Liste der aufgerufenen Funktionen entfernt werden soll. Diese Funktion darf die gesendete Energie-IRP nicht abschließen. Der Rückgabewert dieser Funktion muss STATUS_SUCCESS werden. KsSetPowerDispatch- kann beim Ausführen dieser Power Dispatch-Routine aufgerufen werden, wenn der Zweck besteht, diesen Listeneintrag nur zu bearbeiten. Das Bearbeiten anderer Listeneinträge kann die aktuelle Enumeration verwechseln.

[in, optional] PowerContext

Enthält optional den Kontextparameter, der an die Power Dispatch-Funktion übergeben werden soll.

Rückgabewert

Nichts

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	ks.h (enthalten Ks.h)
Library	Ks.lib

Siehe auch

KStrContextDispatch-

Freigeben über