POFXCALLBACKENUMERATEUNMASKEDINTERRUPTS-Rückruffunktion (pepfx.h)
Die EnumerateUnmaskedInterrupts-Routine listet Interruptquellen auf, deren Interrupts 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 dieser Parameter nicht NULL ist, ist dieser Parameter ein Handle, das das Plattformerweiterungs-Plug-In (PEP) identifiziert. In diesem Fall listet EnumerateUnmaskedInterrupts nur Interrupts auf, die von diesem PEP verwaltet werden. Wenn dieser Parameter NULL ist, listet EnumerateUnmaskedInterruptsalle Interrupts auf der Hardwareplattform auf, die entmasket und aktiviert sind.
[in, optional] EnumerateFlags
Derzeit 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 erfolgen synchron, bevor die EnumerateUnmaskedInterrupts-Routine zurückgegeben wird .
[in] CallbackContext
Ein Zeiger auf einen Rückrufkontext. Dieser Zeiger wird als Parameter an die Rückrufroutine EnumerateInterruptSource übergeben, auf die der Callback-Parameter verweist. Der Inhalt des Rückrufkontexts ist PEP-definiert und für das Power Management Framework (PoFx) undurchsichtig.
[in, out] InterruptInformation
Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, dessen Größe mindestens sizeof (PEP_UNMASKED_INTERRUPT_INFORMATION) Bytes ist. EnumerateUnmaskedInterrupts verwendet diesen Puffer, um Unterbrechungsinformationen während der Aufrufe der Rückrufroutine EnumerateInterruptSource des PEP zu übertragen.
Rückgabewert
EnumerateUnmaskedInterrupts gibt STATUS_SUCCESS zurück, wenn der Aufruf die Interrupts erfolgreich auflistet. Mögliche Fehlerrückgabewerte sind der folgende status Code.
| Rückgabewert | Beschreibung |
|---|---|
|
Der Size - oder Version-Member der PEP_UNMASKED_INTERRUPT_INFORMATION-Struktur enthält einen ungültigen Wert. |
Bemerkungen
Diese Routine wird von PoFx implementiert und vom PEP aufgerufen. Das EnumerateUnmaskedInterrupts-Element der PEP_KERNEL_INFORMATION_STRUCT_V3-Struktur ist ein Zeiger auf eine EnumerateUnmaskedInterrupts-Routine .
Bevor die Plattform in einen Systembetriebszustand wechselt, in dem die Interruptcontroller power-gated sind, kann PEP EnumerateUnmaskedInterrupts aufrufen, um die Informationen zu erhalten, die zum ordnungsgemäßen Konfigurieren von Aktivierungscontrollern für Unterbrechungen erforderlich sind, die nicht maskiert bleiben sollen.
Der PEP kann diese Routine unter IRQL <= HIGH_LEVEL aufrufen.
Anforderungen
| Unterstützte Mindestversion (Client) | Unterstützt ab Windows 10. |
| Zielplattform | Windows |
| Kopfzeile | pepfx.h (include Pep_x.h) |
| IRQL | <= HIGH_LEVEL |