HvCallRestorePartitionTime

Hipercall HvCallRestorePartitionTime ustawia czas odwołania partycji i TSC na wartości zapisane wcześniej przez partycję. Partycja używa jej podczas wznawiania od hibernacji, aby czas nie przechodził wstecz.

Architektura: tylko x64.

Aby wywnioskować dostępność tego hipercall, należy użyć następujących kontroli:

Interface

HV_STATUS
HvCallRestorePartitionTime(
    _In_ HV_PARTITION_ID PartitionId,
    _In_ UINT32 TscSequence,
    _In_ UINT64 ReferenceTime,
    _In_ UINT64 Tsc
    );

Przed hibernacji partycja zapisuje czas odwołania, TscSequence wartość z tej samej odczytu strony TSC odwołania i wartość TSC. Po wznowieniu przekazuje te wartości do HvCallRestorePartitionTime raz, zanim inny kod odczytuje czas. Aby zachować czas przed przejściem do tyłu, Tsc nie powinna być niższa niż jakakolwiek wartość TSC, którą procesor wirtualny odczytuje i ReferenceTime nie powinna być niższa niż jakikolwiek czas odwołania, który został odczytany przez partycję.

Funkcja hypervisor ustawia funkcję TSC każdego procesora wirtualnego, w każdej liście VTL na Tsc, i ustawia licznik odwołań partycji, tak aby był odczytywany ReferenceTime , gdy funkcja TSC odczytuje Tscwartość . Funkcja hypervisor zmienia również wartość IA32_TSC_ADJUST każdego procesora wirtualnego w celu odzwierciedlenia zmiany TSC.

Jeśli strona TSC odwołania jest prawidłowa, funkcja hypervisor zapisuje TscSequence na stronie, a następnie aktualizuje stronę tak, aby czas odwołania był kontynuowany z ReferenceTime. TscSequence Wynik może różnić się od przekazanej wartości. Jeśli TscSequence wartość to 0, strona jest nieprawidłowa po wywołaniu. W obu przypadkach partycja musi postępować zgodnie z protokołem strony TSC odwołania.

Kod wywołania

0x0103 (Proste)

Restrictions

  • Partycja musi mieć uprawnienia AccessPartitionReferenceCounter i AccessPartitionReferenceTsc.
  • Partycja nie może być partycją główną ani partycją odizolowaną od sprzętu.
  • Obiekt wywołujący musi działać w najwyższej włączonej partycji VTL.

Parametry wejściowe

Name Offset Size Podane informacje
PartitionId 0 8 Określa partycję, której czas jest przywracany. Partycja przywraca własny czas, określając HV_PARTITION_ID_SELF.
TscSequence 8 4 Określa TscSequence wartość ze strony TSC odwołania odczytanej, która wygenerowała ReferenceTimewartość lub 0, jeśli strona była niedostępna lub nieprawidłowa.
RsvdZ 12 4
ReferenceTime 16 8 Określa czas odniesienia partycji do przywrócenia w 100-nanosekundowych jednostkach.
Tsc 24 8 Określa wartość TSC odpowiadającą .ReferenceTime

Zwracane wartości

Kod stanu Warunek błędu
HV_STATUS_ACCESS_DENIED Obiekt wywołujący nie może uzyskać dostępu do określonej partycji.
Partycja nie obsługuje przywracania czasu.
Partycja nie ma uprawnień AccessPartitionReferenceCounter lub AccessPartitionReferenceTsc.
Partycja to partycja główna lub partycja izolowana sprzętowo.
Obiekt wywołujący nie jest uruchomiony w najwyższej włączonej sieci VTL dla swojej partycji.
HV_STATUS_INVALID_PARTITION_ID Określony identyfikator partycji jest nieprawidłowy.
HV_STATUS_INVALID_PARTITION_STATE Określona partycja nie jest w stanie "aktywny".

Informacje dodatkowe