次の方法で共有

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) を識別するハンドルです。この場合、EnumerateUnmaskedInterrupts 、この PEP によって管理される割り込みのみが列挙されます。 このパラメーターが NULL の場合、EnumerateUnmaskedInterrupts は、マスク解除されて有効になっているハードウェア プラットフォームのすべての 割り込みを列挙。

[in, optional] EnumerateFlags

フラグは現在定義されていません。 このパラメーターを PEP_ENUMERATE_UNMASKED_INTERRUPT_FLAGS_NONE (0x0) に設定します。

[in] Callback

EnumerateInterruptSource コールバック ルーチン 呼び出し元によって実装されるポインター。 このコールバック ルーチンは、割り込みがマスクされていない割り込みソースごとに 1 回呼び出されます。 これらのコールバックは、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 によって呼び出されます。 EnumerateUnmaskedInterruptsPEP_KERNEL_INFORMATION_STRUCT_V3 構造体のメンバーは、EnumerateUnmaskedInterrupts ルーチンへのポインターです。

プラットフォームがシステムの電源状態に入り、割り込みコントローラーの電源が入る前に、PEP は EnumerateUnmaskedInterrupts を呼び出して、マスクされていない割り込みのためにウェイクアップ コントローラーを適切に構成するために必要な情報を取得できます。

PEP は IRQL <= HIGH_LEVEL でこのルーチンを呼び出すことができます。

必要条件

要件 価値
サポートされる最小クライアント Windows 10 以降でサポートされています。
ターゲット プラットフォーム の ウィンドウズ
ヘッダー pepfx.h (Pep_x.h を含む)
IRQL <= HIGH_LEVEL

関連項目

EnumerateInterruptSource

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_UNMASKED_INTERRUPT_INFORMATION