POFXCALLBACKENUMERATEUNMASKEDINTERRUPTS Callback-Funktion (pepfx.h)

Die Routine "EnumerateUnmaskedInterrupts " listet Unterbrechungsquellen auf, 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 nicht NULL, ist dieser Parameter ein Handle, der das Plattformerweiterungs-Plug-In (PEP) identifiziert, in diesem Fall EnumerateUnmaskedInterrupts nur Unterbrechungen aufzählt, die von diesem PEP verwaltet werden. Wenn dieser Parameter NULL ist, EnumerateUnmaskedInterruptswerden alle Unterbrechungen auf der Hardwareplattform aufgezählt, die unmasket 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 einmal für jede Unterbrechungsquelle aufgerufen, deren Unterbrechung entmasket ist. Diese Rückrufe treten synchron auf, bevor die Routine "EnumerateUnmaskedInterrupts" zurückgibt.

[in] CallbackContext

Ein Zeiger auf einen Rückrufkontext. Dieser Zeiger wird als Parameter an die Rückrufroutine "EnumerateInterruptSource " übergeben, auf die der Rückrufparameter verweist. Die Inhalte des Rückrufkontexts sind PEP-definiert und sind undurchsichtig für das Power Management Framework (PoFx).

[in, out] InterruptInformation

Ein Zeiger auf einen aufrufer-zugeordneten Puffer, dessen Größe mindestens "sizeof(PEP_UNMASKED_INTERRUPT_INFORMATION)"-Bytes ist. EnumerateUnmaskedInterrupts verwenden diesen Puffer, um Unterbrechungsinformationen während Aufrufen der EnumerateInterruptSource-Rückrufroutine von PEP an den PEP zu übertragen.

Rückgabewert

EnumerateUnmaskedInterrupts gibt STATUS_SUCCESS zurück, wenn der Aufruf die Unterbrechungen erfolgreich aufzählt. Mögliche Fehlerrückgabewerte umfassen den folgenden Statuscode.

Rückgabewert BESCHREIBUNG
STATUS_INVALID_PARAMETER
Das Element "Größe " oder "Version " 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 Element "EnumerateUnmaskedInterrupts" der PEP_KERNEL_INFORMATION_STRUCT_V3 Struktur ist ein Zeiger auf eine EnumerateUnmaskedInterrupts-Routine .

Bevor die Plattform einen Systemleistungszustand eingibt, in dem die Unterbrechungscontroller power-gated sind, kann die PEP EnumerateUnmaskedInterrupts aufrufen, um die Informationen abzurufen, die sie benötigt, um Weckcontroller für Unterbrechungen ordnungsgemäß zu konfigurieren, die nicht maskiert bleiben sollen.

Die PEP kann diese Routine bei 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

Weitere Informationen

AufzählenInterruptSource

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_UNMASKED_INTERRUPT_INFORMATION