次の方法で共有

PCI_MSIX_SET_ENTRY コールバック関数 (wdm.h)

  • [アーティクル]

SetTableEntry ルーチンは、MSI-X ハードウェア割り込みテーブルのテーブル エントリのメッセージ ID を設定します。

構文

PCI_MSIX_SET_ENTRY PciMsixSetEntry;

NTSTATUS PciMsixSetEntry(
  [in] PVOID Context,
  [in] ULONG TableEntry,
  [in] ULONG MessageNumber
)
{...}

パラメーター

[in] Context

インターフェイス固有のコンテキスト情報へのポインター。 呼び出し元は、インターフェイスの PCI_MSIX_TABLE_CONFIG_INTERFACE 構造体のメンバー コンテキストとして渡される値を渡します。

[in] TableEntry

MSI-X ハードウェア割り込みテーブル内のテーブル エントリのインデックス。

[in] MessageNumber

割り込みのメッセージ ID。 この値は、ドライバーのメッセージシグナル割り込みを記述する IO_INTERRUPT_MESSAGE_INFO 構造体の MessageInfo メンバー内の割り込みのエントリのインデックスでもあります。 IoConnectInterruptEx 関数は、この構造体へのポインターを提供します。

戻り値

SetTableEntry ルーチンは、次のいずれかの NTSTATUS 値を返します。

リターン コード 形容
STATUS_SUCCESS
 操作が正常に完了しました。
STATUS_INVALID_PARAMETER
 デバイスが MSI-X を使用しないか、TableEntry または MessageNumber パラメーター、デバイスに割り当てられている割り込みリソースに対応していません。

備考

既定では、オペレーティング システムは割り込みのメッセージ ID としてテーブル エントリのインデックスを割り当てます。 メッセージより多くのテーブル項目がある場合、システムは、メッセージ 0 に対応するように残りの表項目を設定します。 ドライバーは、SetTableEntry ルーチンを使用して、別のメッセージ ID を割り当てることができます。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista Service Pack 1 (SP1)、Windows Server 2008、およびそれ以降のバージョンの Windows オペレーティング システムで使用できます。
ターゲット プラットフォーム の デスクトップ
ヘッダー wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
IRQL <= DIRQL

関連項目

IO_INTERRUPT_MESSAGE_INFO

IoConnectInterruptEx の

PCI_MSIX_TABLE_CONFIG_INTERFACE