Funzione di callback POFXCALLBACKENUMERATEUNMASKEDINTERRUPTS (pepfx.h)

La routine EnumerateUnmaskedInterrupts enumera le origini di interrupt i cui interrupt sono senza maschera 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 le interruzioni gestite da questo PEP. Se questo parametro è NULL, EnumerateUnmaskedInterrupts enumera tutti gli interrupt nella piattaforma hardware non mascherati 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 callback EnumerateInterruptSource implementata dal chiamante. Questa routine di callback viene chiamata una volta per ogni origine di interrupt il cui interrupt non viene mascherato. Questi callback vengono eseguiti 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 punta il parametro Callback . Il contenuto del contesto di callback è definito da PEP e non è opaco al framework di risparmio energia (PoFx).

[in, out] InterruptInformation

Puntatore a un buffer allocato dal chiamante la cui dimensione è di 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 interrupt. I valori restituiti di errore possibili includono il codice di stato seguente.

Commenti

Questa routine viene implementata da PoFx ed è 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 interrupt che devono rimanere mascherati.

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

Requisiti

Vedi anche

EnumerateInterruptSource

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_UNMASKED_INTERRUPT_INFORMATION