POFXCALLBACKENUMERATEUNMASKEDINTERRUPTS-Rückruffunktion (pepfx.h)

Artikel
02/26/2024

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 nicht NULL, 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 caller-implementierte EnumerateInterruptSource-Rückrufroutine . Diese Rückrufroutine wird für jede Interruptquelle, deren Interrupt entmasket ist, einmal aufgerufen. 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 vom Rückrufparameter verwiesen wird. 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 Aufrufen 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 umfassen den folgenden status Code.

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

Hinweise

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 eingeschaltet sind, kann pep EnumerateUnmaskedInterrupts aufrufen, um die Informationen abzurufen, die zum ordnungsgemäßen Konfigurieren der Aktivierungscontroller für Interrupts benötigt werden, die unmaskiert bleiben sollen.

Die PEP kann diese Routine unter IRQL <= HIGH_LEVEL aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Wird ab Windows 10 unterstützt.
Zielplattform	Windows
Kopfzeile	pepfx.h (einschließlich Pep_x.h)
IRQL	<= HIGH_LEVEL

Weitere Informationen

EnumerateInterruptSource

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_UNMASKED_INTERRUPT_INFORMATION

Freigeben über