POFXCALLBACKPLATFORMIDLEVETO-Rückruffunktion (pepfx.h)
Die PlatformIdleVeto-Routine erhöht oder verringert die Vetoanzahl für einen Vetocode für einen Plattform-Leerlaufzustand.
Syntax
POFXCALLBACKPLATFORMIDLEVETO Pofxcallbackplatformidleveto;
NTSTATUS Pofxcallbackplatformidleveto(
[in] POHANDLE ProcessorHandle,
[in] ULONG PlatformState,
[in] ULONG VetoReason,
[in] BOOLEAN Increment
)
{...}
Parameter
[in] ProcessorHandle
Ein POHANDLE-Wert, der die Registrierung des Prozessors (als Gerät) beim Power Management Framework (PoFx) darstellt. Das Plattformerweiterungs-Plug-In (PEP) erhielt dieses Handle zuvor von PoFx während der PEP_DPM_REGISTER_DEVICE Benachrichtigung, die pep darüber informierte, dass der Prozessor bei PoFx registriert wurde.
[in] PlatformState
Der Index des Plattform-Leerlaufzustands, dessen Vetoanzahl erhöht oder verringert wird. Der PEP hat zuvor die unterstützten Plattform-Leerlaufzustände als Reaktion auf eine PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES Benachrichtigung angegeben. Wenn der VON PEP angegebene Leerlaufzustand der N-Plattform angegeben ist, reichen die gültigen Plattform-Leerlaufstatusindizes von 0 bis N–1.
[in] VetoReason
Ein von PEP definierter Vetocode, der angibt, warum der Leerlaufzustand der Plattform nicht eingegeben werden kann. Der PEP hat zuvor die Anzahl der unterstützten Vetogründe als Reaktion auf eine PEP_NOTIFY_PPM_QUERY_VETO_REASONS Benachrichtigung angegeben. Wenn der PEP M-Veto-Gründe angegeben hat, reichen die gültigen Vetocodes von 1 bis M.
[in] Increment
Gibt an, ob die Anzahl des Vetos erhöht oder verringert werden soll. Legen Sie auf TRUE fest, um die Vetoanzahl aus diesem Grund zu erhöhen, oder auf FALSE, um die Anzahl zu verringern.
Rückgabewert
PlatformIdleVeto gibt STATUS_SUCCESS zurück, wenn der Aufruf die Vetoanzahl erfolgreich erhöht oder verringert. Mögliche Fehlerrückgabewerte umfassen den folgenden status Code.
| Rückgabewert | BESCHREIBUNG |
|---|---|
|
Gibt an, dass die PlatformIdleVeto-Routine für diesen Prozessor nicht implementiert ist. |
Hinweise
Diese Routine wird vom PoFx implementiert und vom PEP aufgerufen. Das PlatformIdleVeto-Element der PEP_KERNEL_INFORMATION_STRUCT_V3-Struktur ist ein Zeiger auf eine PlatformIdleVeto-Routine .
Nachdem pep die PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES Benachrichtigung verarbeitet hat, beginnt jeder Plattform-Leerlaufzustand mit einer Vetoanzahl von 0 für alle Vetocodes. Pep kann die Vetoanzahl eines Vetocodes erhöhen, um zu verhindern, dass das Betriebssystem die Plattform in diesen Leerlaufzustand überwechselt. Der PEP verringert die Vetoanzahl, wenn der Vetogrund, der dazu geführt hat, dass die Anzahl erhöht wurde, nicht mehr wirksam ist. Erst nachdem die Anzahl aller Vetocodes auf null verringert wurde, darf das Betriebssystem die Plattform in diesen Leerlaufzustand überstellen.
Diese Routine muss unter IRQL = PASSIVE_LEVEL aufgerufen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Wird ab Windows 10 unterstützt. |
| Zielplattform | Windows |
| Kopfzeile | pepfx.h (einschließlich Pep_x.h) |
| IRQL | PASSIVE_LEVEL |
Weitere Informationen
PEP_KERNEL_INFORMATION_STRUCT_V3