HvCallRestorePartitionTime

L'hypercall HvCallRestorePartitionTime imposta l'ora di riferimento di una partizione e il TSC sui valori salvati in precedenza dalla partizione. Una partizione lo usa quando riprende dall'ibernazione, in modo che il tempo non vada indietro.

Architettura: solo x64.

Per dedurre la disponibilità di questa hypercall, è necessario usare i controlli seguenti:

Interface

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

Prima di ibernare, la partizione salva il tempo di riferimento, il TscSequence valore dalla stessa lettura della pagina TSC di riferimento e un valore TSC. Al termine della ripresa, questi valori vengono passati a HvCallRestorePartitionTime una sola volta, prima che l'altro codice legga il tempo. Per evitare che il tempo passi indietro, Tsc non deve essere inferiore a qualsiasi valore TSC letto da un processore virtuale e ReferenceTime non deve essere inferiore a qualsiasi ora di riferimento che la partizione ha letto.

L'hypervisor imposta il TSC di ogni processore virtuale, in ogni VTL, su Tsce imposta il contatore dei riferimenti ReferenceTimeTscalla partizione in modo che venga letto quando il TSC legge . L'hypervisor modifica anche il valore IA32_TSC_ADJUST di ogni processore virtuale in modo da riflettere la modifica del TSC.

Se la pagina TSC di riferimento è valida, l'hypervisor scrive TscSequence nella pagina, aggiorna la pagina in modo che il tempo di riferimento continui da ReferenceTime. L'oggetto risultante TscSequence può differire dal valore passato. Se TscSequence è 0, la pagina non è valida dopo la chiamata. In entrambi i casi, la partizione deve seguire il protocollo di pagina TSC di riferimento.

Chiama codice

0x0103 (Semplice)

Restrictions

  • La partizione deve possedere i privilegi AccessPartitionReferenceCounter e AccessPartitionReferenceTsc.
  • La partizione non può essere la partizione radice o una partizione isolata dall'hardware.
  • Il chiamante deve essere eseguito nella VTL più alta abilitata per la partizione.

Parametri di input

Name Offset Size Informazioni fornite
PartitionId 0 8 Specifica la partizione di cui viene ripristinato l'ora. Una partizione ripristina il proprio tempo specificando HV_PARTITION_ID_SELF.
TscSequence 8 4 Specifica il TscSequence valore della pagina TSC di riferimento letto che ha prodotto ReferenceTimeo 0 se la pagina non è disponibile o non è valida.
RsvdZ 12 4
ReferenceTime 16 8 Specifica il tempo di riferimento della partizione da ripristinare, in unità da 100 nanosecondi.
Tsc 24 8 Specifica il valore TSC che corrisponde a ReferenceTime.

Valori restituiti

Codice di stato Condizione di errore
HV_STATUS_ACCESS_DENIED Il chiamante non è autorizzato ad accedere alla partizione specificata.
La partizione non supporta il ripristino del tempo.
La partizione non possiede il privilegio AccessPartitionReferenceCounter o AccessPartitionReferenceTsc.
La partizione è la partizione radice o una partizione isolata dall'hardware.
Il chiamante non è in esecuzione nella VTL più alta abilitata per la partizione.
HV_STATUS_INVALID_PARTITION_ID L'ID di partizione specificato non è valido.
HV_STATUS_INVALID_PARTITION_STATE La partizione specificata non è nello stato "attivo".

Vedere anche