HvCallSignalEvent ハイパーコールは、指定された接続に関連付けられているポートを所有するパーティション内のイベントを通知します。
イベントは、受信パーティションの仮想プロセッサの 1 つの SIEF ページ内でビットを設定することによって通知されます。 呼び出し元は、相対フラグ番号を指定します。 実際の SIEF ビット番号は、指定されたフラグ番号をポートに関連付けられている基本フラグ番号に追加することによって、ハイパーバイザーによって計算されます。
インターフェイス
HV_STATUS
HvCallSignalEvent(
_In_ HV_CONNECTION_ID ConnectionId,
_In_ UINT16 FlagNumber
);
呼び出しコード
0x005D (シンプル)
入力パラメーター
| 名前 | Offset | サイズ | 情報提供済み |
|---|---|---|---|
ConnectionId |
0 | 4 | 接続の ID を指定します。 |
FlagNumber |
4 | 2 | 呼び出し元がターゲット SIEF 領域内で設定するイベント フラグの相対インデックスを指定します。 この番号は、ポートに関連付けられている基本フラグ番号を基準にしています。 |
| RsvdZ | 6 | 2 |
戻り値
| status code | エラー条件 |
|---|---|
HV_STATUS_ACCESS_DENIED |
呼び出し元のパーティションには SignalEvents 特権がありません。 |
HV_STATUS_INVALID_CONNECTION_ID |
指定された接続 ID が無効です。 |
HV_STATUS_INVALID_PORT_ID |
指定された接続に関連付けられているポートが削除されました。 |
| 指定された接続に関連付けられているポートは、"アクティブ" 状態ではないパーティションに属しています。 | |
| 指定した接続に関連付けられているポートは、"イベント" 型のポートではありません。 | |
HV_STATUS_INVALID_PARAMETER |
指定したフラグ番号は、ポートのフラグ数以上です。 |
HV_STATUS_INVALID_VP_INDEX |
ターゲット VP が存在しなくなったか、メッセージを投稿できる使用可能な VP がありません。 |
HV_STATUS_INVALID_SYNIC_STATE |
ターゲット VP の SynIC は無効になっており、シグナルイベントを受け入れることができません。 |
| ターゲット VP の SIEF ページが無効になっています。 |