Funzione di callback POFXCALLBACKENUMERATEUNMASKEDINTERRUPTS (pep_x.h)

Articolo
02/07/2025

La routine EnumerateUnmaskedInterrupts enumera le origini di interrupt i cui interrupt non sono mascherati e abilitati.

Sintassi

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
)
{...}

Parametri

[in, optional] PluginHandle

Valore POHANDLE. Se non NULL, questo parametro è un handle che identifica il plug-in di estensione della piattaforma (PEP), nel qual caso EnumerateUnmaskedInterrupts enumera solo gli interrupt gestiti da questo PEP. Se questo parametro è NULL, EnumerateUnmaskedInterrupts enumera tutti gli interrupt nella piattaforma hardware non mascherati e abilitati.

[in, optional] EnumerateFlags

Nessun flag è attualmente definito. Impostare questo parametro su PEP_ENUMERATE_UNMASKED_INTERRUPT_FLAGS_NONE (0x0).

[in] Callback

Puntatore a un chiamante implementato EnumerateInterruptSource routine di callback. Questa routine di callback viene chiamata una volta per ogni origine interrupt il cui interrupt non viene mascherato. Questi callback si verificano in modo sincrono prima che venga restituita la routine EnumerateUnmaskedInterrupts.

[in] CallbackContext

Puntatore a un contesto di callback. Questo puntatore viene passato come parametro al EnumerateInterruptSource routine di callback a cui punta il parametro Callback. I contenuti del contesto di callback sono definiti da PEP e sono opachi per il framework di risparmio energia (PoFx).

[in, out] InterruptInformation

Puntatore a un buffer allocato dal chiamante la cui dimensione è almeno sizeof(PEP_UNMASKED_INTERRUPT_INFORMATION) byte. EnumerateUnmaskedInterrupts userà questo buffer per trasferire le informazioni di interrupt al PEP durante le chiamate alla routine di callback EnumerateInterrupt Source di PEP.

Valore restituito

EnumerateUnmaskedInterrupts restituisce STATUS_SUCCESS se la chiamata enumera correttamente gli interrupt. I possibili valori restituiti dall'errore includono il codice di stato seguente.

Valore restituito	Descrizione
STATUS_INVALID_PARAMETER	Il membro Size o Version della struttura PEP_UNMASKED_INTERRUPT_INFORMATION contiene un valore non valido.

Osservazioni

Questa routine viene implementata da PoFx e viene chiamata dal PEP. Il EnumerateUnmaskedInterrupts membro della struttura PEP_KERNEL_INFORMATION_STRUCT_V3 è un puntatore a una routine EnumerateUnmaskedInterrupts.

Prima che la piattaforma entri in uno stato di alimentazione del sistema in cui i controller di interruzione sono power gated, il PEP può chiamare EnumerateUnmaskedInterrupts per ottenere le informazioni necessarie per configurare correttamente i controller di riattivazione per gli interrupt che devono rimanere smascherati.

Il PEP può chiamare questa routine in IRQL <= HIGH_LEVEL.

Fabbisogno

Requisito	Valore
client minimo supportato	Supportato a partire da Windows 10.
piattaforma di destinazione	Finestre
intestazione	pep_x.h (includere Pep_x.h)
IRQL	<= HIGH_LEVEL

Vedere anche

EnumerateInterruptSource

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_UNMASKED_INTERRUPT_INFORMATION

Condividi tramite