HvCallSignalEvent

Artikel
07/13/2023

Der Hypercall HvCallSignalEvent signalisiert ein Ereignis in einer Partition, das den Port besitzt, der der angegebenen Verbindung zugeordnet ist.

Das Ereignis wird durch Festlegen eines Bits auf der SIEF-Seite eines der virtuellen Prozessoren der Empfangspartition signalisiert. Der Aufrufer gibt eine relative Flagnummer an. Die tatsächliche SIEF-Bitnummer wird vom Hypervisor berechnet, indem die angegebene Flagnummer zur Basisflaggennummer hinzugefügt wird, die dem Port zugeordnet ist.

Schnittstelle

HV_STATUS
HvCallSignalEvent(
   _In_ HV_CONNECTION_ID ConnectionId,
   _In_ UINT16 FlagNumber
   );

Aufrufcode

0x005D (Einfach)

Eingabeparameter

Name	Offset	Size	Informationen bereitgestellt
`ConnectionId`	0	4	Gibt die ID der Verbindung an.
`FlagNumber`	4	2	Gibt den relativen Index des Ereignisflags an, das der Aufrufer innerhalb des ZIEL-SIEF-Bereichs festlegen möchte. Diese Zahl ist relativ zur Basisflagnummer, die dem Port zugeordnet ist.
RsvdZ	6	2

Rückgabewerte

Statuscode	Fehlerbedingung
`HV_STATUS_ACCESS_DENIED`	Die Partition des Aufrufers besitzt nicht die SignalEvents-Berechtigung.
`HV_STATUS_INVALID_CONNECTION_ID`	Die angegebene Verbindungs-ID ist ungültig.
`HV_STATUS_INVALID_PORT_ID`	Der der angegebenen Verbindung zugeordnete Port wurde gelöscht.
	Der der angegebenen Verbindung zugeordnete Port gehört zu einer Partition, die sich nicht im Status "aktiv" befindet.
	Der der angegebenen Verbindung zugeordnete Port ist kein Port vom Typ "Ereignis".
`HV_STATUS_INVALID_PARAMETER`	Die angegebene Flagnummer ist größer oder gleich der Flaganzahl des Ports.
`HV_STATUS_INVALID_VP_INDEX`	Der Ziel-VP ist nicht mehr vorhanden, oder es gibt keine verfügbaren VPs, an die die Nachricht gesendet werden kann.
`HV_STATUS_INVALID_SYNIC_STATE`	Die SynIC des Ziel-VP ist deaktiviert und kann keine signalisierten Ereignisse akzeptieren.
	Die SIEF-Seite des Ziel-VP ist deaktiviert.

Freigeben über