POFXCALLBACKPLATFORMIDLEVETO-Rückruffunktion (pep_x.h)

  • Artikel

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
STATUS_NOT_IMPLEMENTED
 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 pep_x.h (einschließlich Pep_x.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES

PEP_NOTIFY_PPM_QUERY_VETO_REASONS