Funzione di callback POFXCALLBACKENUMERATEUNMASKEDINTERRUPTS (pep_x.h)

La routine EnumerateUnmaskedInterrupts enumera le origini di interruzione i cui interruzioni non vengono mascherate e abilitate.

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 dell'estensione della piattaforma (PEP), nel qual caso EnumerateUnmaskedInterrupts enumera solo gli interruzioni gestiti da questo PEP. Se questo parametro è NULL, EnumerateUnmaskedInterrupts enumera tutti gli interruzioni nella piattaforma hardware non crittografati e abilitati.

[in, optional] EnumerateFlags

Non sono attualmente definiti flag. Impostare questo parametro su PEP_ENUMERATE_UNMASKED_INTERRUPT_FLAGS_NONE (0x0).

[in] Callback

Puntatore a una routine di caller implementata da EnumerateInterruptSource . Questa routine di callback viene chiamata una volta per ogni origine di interruzione il cui interruzione non viene mascherata. Questi callback si verificano in modo sincrono prima che la routine EnumerateUnmaskedInterrupts restituisca.

[in] CallbackContext

Puntatore a un contesto di callback. Questo puntatore viene passato come parametro alla routine di callback EnumerateInterruptSource a cui fa riferimento il parametro Callback . Il contenuto del contesto di callback è definito da PEP e è opaco al framework di gestione 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 interruzione al PEP durante le chiamate alla routine di callback EnumerateInterruptSource di PEP.

Valore restituito

EnumerateUnmaskedInterrupts restituisce STATUS_SUCCESS se la chiamata enumera correttamente gli interruzioni. I valori restituiti degli errori possibili includono il codice di stato seguente.

Commenti

Questa routine viene implementata da PoFx e viene chiamata dal PEP. Il membro EnumerateUnmaskedInterrupts 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 interruzioni che devono rimanere smascherati.

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

Requisiti

Vedi anche

EnumerateInterruptSource

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_UNMASKED_INTERRUPT_INFORMATION