共用方式為

POFXCALLBACKENUMERATEUNMASKEDINTERRUPTS 回呼函式 (pep_x.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) ，在此情況下 ，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

呼叫端配置的緩衝區指標，其大小至少為 sizeof (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
標頭 pep_x.h (包含 Pep_x.h)
IRQL <= HIGH_LEVEL

另請參閱

EnumerateInterruptSource

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_UNMASKED_INTERRUPT_INFORMATION