仮想プロセッサ上の合成割り込みコントローラー (SynIC) イベント フラグを通知します。
構文
typedef UINT8 WHV_VTL;
typedef struct WHV_SYNIC_EVENT_PARAMETERS
{
UINT32 VpIndex;
UINT8 TargetSint;
WHV_VTL TargetVtl;
UINT16 FlagNumber;
} WHV_SYNIC_EVENT_PARAMETERS;
HRESULT
WINAPI
WHvSignalVirtualProcessorSynicEvent(
_In_ WHV_PARTITION_HANDLE Partition,
_In_ WHV_SYNIC_EVENT_PARAMETERS SynicEvent,
_Out_opt_ BOOL* NewlySignaled
);
Parameters
Partition
パーティション オブジェクトへのハンドル。
SynicEvent
イベントのターゲットを指定します。
VpIndex は仮想プロセッサを識別し、 TargetSint は合成割り込みソース (SINT) を識別し、 TargetVtl はターゲット仮想信頼レベルを識別し、 FlagNumber は設定するイベント フラグを識別します。
NewlySignaled
NULL 以外の場合は、この呼び出しの結果としてイベント フラグが clear から set に遷移した場合に TRUE を受け取り、フラグが既に設定されているかどうかを FALSE します。
戻り値
関数が成功した場合、戻り値は S_OK。
TargetVtlが0されていない場合、関数はE_INVALIDARGを返します。 ターゲット仮想プロセッサの合成割り込みコントローラーがイベントを受信するように構成されていない場合、関数は HRESULT_FROM_WIN32(ERROR_HV_INVALID_SYNIC_STATE)を返します。
Remarks
WHvSignalVirtualProcessorSynicEvent関数は、ターゲット仮想プロセッサの SynIC イベント フラグ ページでFlagNumberによって識別されるイベント フラグを設定し、指定された SINT でエッジによってトリガーされる割り込みを提供します。 これは、SynIC イベント ポートを介してゲストに通知するために使用されるメカニズムです。
NewlySignaled出力は、この呼び出しが既に保留中のフラグと設定したフラグを区別します。
Requirements
| 要件 | 価値 |
|---|---|
| サポートされている最小Windows | Windows 10バージョン 20H2 (x64);Windows 11、バージョン 24H2、ビルド 26100.3915 (Arm64) |
| Header | WinHvPlatform.h |
| 図書館 | WinHvPlatform.lib |
| DLL | WinHvPlatform.dll |
| Architecture | x64、Arm64 |