POFXCALLBACKENUMERATEUNMASKEDINTERRUPTS 回呼函式 (pepfx.h)

  • 發行項

EnumerateUnmaskedInterrupts 例程會列舉中斷來源，其中斷會解除遮罩並啟用。

語法

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

參數

[in, optional] PluginHandle

POHANDLE 值。 如果非 NULL，此參數是識別 PEP (PEP) 平臺延伸模組外掛程式的句柄，在此情況下 EnumerateUnmaskedInterrupts 只會列舉此 PEP 所管理的中斷。 如果此參數為 NULL，EnumerateUnmaskedInterrupts 會在未遮罩和啟用的硬體平臺中列舉 所有 中斷。

[in, optional] EnumerateFlags

目前未定義任何旗標。 將此參數設定為 PEP_ENUMERATE_UNMASKED_INTERRUPT_FLAGS_NONE (0x0) 。

[in] Callback

呼叫端實作 EnumerateInterruptSource 回呼例程的指標。 此回呼例程會針對中斷未遮罩的每個中斷來源呼叫一次。 這些回呼會在 EnumerateUnmaskedInterrupts 例程傳回之前同步發生。

[in] CallbackContext

回呼內容的指標。 這個指標會當做參數傳遞至 Callback 參數所指向 的 EnumerateInterruptSource回呼 例程。 回呼內容的內容是 PEP 定義，而且與 電源管理架構 不透明， (PoFx) 。

[in, out] InterruptInformation

呼叫端配置緩衝區的指標，其大小至少為 大小 (PEP_UNMASKED_INTERRUPT_INFORMATION) 位元組。 EnumerateUnmaskedInterrupts 會在呼叫 PEP 的 EnumerateInterruptSource 回呼例程期間，使用此緩衝區將中斷資訊傳送至 PEP。

傳回值

如果呼叫成功列舉中斷，EnumerateUnmaskedInterrupts 會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列狀態代碼。

傳回值 描述
STATUS_INVALID_PARAMETER
 PEP_UNMASKED_INTERRUPT_INFORMATION 結構的 Size 或 Version 成員包含無效的值。

備註

此例程是由 PoFx 所實作，並由 PEP 呼叫。 PEP_KERNEL_INFORMATION_STRUCT_V3 結構的 EnumerateUnmaskedInterrupts 成員是 EnumerateUnmaskedInterrupts 例程的指標。

在平臺進入系統電源狀態時，插斷控制器處於電源網關狀態之前，PEP 可以呼叫 EnumerateUnmaskedInterrupts 以取得正確設定喚醒控制器所需的資訊，讓中斷保持未遮罩。

PEP 可以在 IRQL <= HIGH_LEVEL呼叫此例程。

規格需求

需求 值
最低支援的用戶端 從Windows 10 開始支援。
目標平台 Windows
標頭 pepfx.h (包含 Pep_x.h)
IRQL <= HIGH_LEVEL

另請參閱

EnumerateInterruptSource

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_UNMASKED_INTERRUPT_INFORMATION