POFXCALLBACKENUMERATEUNMASKEDINTERRUPTS-Rückruffunktion (pep_x.h)

Artikel
02/07/2025

Die EnumerateUnmaskedInterrupts Routineunterbruchquellen aufzählt, deren Unterbrechungen entmasket und aktiviert sind.

Syntax

POFXCALLBACKENUMERATEUNMASKEDINTERRUPTS Pofxcallbackenumerateunmaskedinterrupts;

NTSTATUS Pofxcallbackenumerateunmaskedinterrupts(
  [in, optional] POHANDLE PluginHandle,
  [in, optional] ULONG EnumerateFlags,
  [in]           PPO_ENUMERATE_INTERRUPT_SOURCE_CALLBACK Callback,
  [in]           PVOID CallbackContext,
  [in, out]      PPEP_UNMASKED_INTERRUPT_INFORMATION InterruptInformation
)
{...}

Parameter

[in, optional] PluginHandle

Ein POHANDLE-Wert. Wenn kein NULL-Wert ist, ist dieser Parameter ein Handle, mit dem das Plattformerweiterungs-Plug-In (PEP) identifiziert wird, in diesem Fall EnumerateUnmaskedInterrupts nur Unterbrechungen aufzählt, die von diesem PEP verwaltet werden. Wenn dieser Parameter NULL ist, werden EnumerateUnmaskedInterruptsalle Unterbrechungen in der Hardwareplattform aufgezählt, die entmasket und aktiviert sind.

[in, optional] EnumerateFlags

Zurzeit sind keine Flags definiert. Legen Sie diesen Parameter auf PEP_ENUMERATE_UNMASKED_INTERRUPT_FLAGS_NONE (0x0) fest.

[in] Callback

Ein Zeiger auf eine vom Aufrufer implementierte EnumerateInterruptSource Rückrufroutine. Diese Rückrufroutine wird einmal für jede Interruptquelle aufgerufen, deren Interrupt entmasket ist. Diese Rückrufe treten synchron auf, bevor die EnumerateUnmaskedInterrupts Routine zurückgegeben wird.

[in] CallbackContext

Ein Zeiger auf einen Rückrufkontext. Dieser Zeiger wird als Parameter an die EnumerateInterruptSource Rückrufroutine übergeben, auf die der Callback--Parameter verweist. Der Inhalt des Rückrufkontexts ist pepdefiniert und ist für das Power Management Framework (PoFx) undurchsichtig.

[in, out] InterruptInformation

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, dessen Größe mindestens Größe(PEP_UNMASKED_INTERRUPT_INFORMATION) Bytes beträgt. EnumerateUnmaskedInterrupts wird diesen Puffer verwenden, um Unterbrechungsinformationen während Der Aufrufe der PEP EnumerateInterruptSource Rückrufroutine an den PEP zu übertragen.

Rückgabewert

EnumerateUnmaskedInterrupts gibt STATUS_SUCCESS zurück, wenn der Aufruf die Unterbrechungen erfolgreich aufzählt. Mögliche Fehlerrücklaufwerte sind der folgende Statuscode.

Rückgabewert	Beschreibung
STATUS_INVALID_PARAMETER	Das Size oder Version Member der PEP_UNMASKED_INTERRUPT_INFORMATION-Struktur enthält einen ungültigen Wert.

Bemerkungen

Diese Routine wird von PoFx implementiert und wird vom PEP aufgerufen. Das EnumerateUnmaskedInterrupts Mitglied der PEP_KERNEL_INFORMATION_STRUCT_V3 Struktur ist ein Zeiger auf eine EnumerateUnmaskedInterrupts Routine.

Bevor die Plattform in einen Systemstromzustand wechselt, in dem die Unterbrechungscontroller power-gated sind, kann der PEP EnumerateUnmaskedInterrupts aufrufen, um die Informationen zu erhalten, die es benötigt, um Wake-Up-Controller für Unterbrechungen ordnungsgemäß zu konfigurieren, die unmasket bleiben sollen.

Der PEP kann diese Routine bei IRQL <= HIGH_LEVEL aufrufen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Wird ab Windows 10 unterstützt.
Zielplattform-	Fenster
Header-	pep_x.h (einschließen Pep_x.h)
IRQL-	<= HIGH_LEVEL

Siehe auch

EnumerateInterruptSource-

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_UNMASKED_INTERRUPT_INFORMATION

Freigeben über