共用方式為

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 回呼例程的指標。 此回呼例程會針對中斷解除遮罩的每個中斷來源呼叫一次。 這些回呼會在傳回例程傳回 EnumerateUnmaskedInterrup ts 之前同步發生。

[in] CallbackContext

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

[in, out] InterruptInformation

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

傳回值

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

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

言論

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

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

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

要求

要求 價值
最低支援的用戶端 從 Windows 10 開始支援。
目標平臺 窗戶
標頭 pep_x.h （包括 Pep_x.h）
IRQL <= HIGH_LEVEL

另請參閱

EnumerateInterruptSource

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_UNMASKED_INTERRUPT_INFORMATION