Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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:
- RestoreTimeOnResume deve essere indicato tramite 0x40000004 foglia CPUID.
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". |