WHvResetPartition

Setzt eine Partition auf den anfangszustand zurück.

Syntax

HRESULT
WINAPI
WHvResetPartition(
    _In_ WHV_PARTITION_HANDLE Partition
    );

Parameter

Partition

Handle to the partition object to reset.

Rückgabewert

Wenn die Funktion erfolgreich ist, lautet S_OKder Rückgabewert .

Wenn sich die Partition in einem Zustand befindet, der keine Zurücksetzung zulässt, gibt die Funktion zurück HRESULT_FROM_WIN32(ERROR_INVALID_STATE).

Remarks

Die WHvResetPartition Funktion setzt die Partition zurück und gibt ihre virtuellen Prozessoren in den Zustand zurück, den sie unmittelbar nach der Einrichtung WHvSetupPartitionder Partition hatten. Der Registerstatus jedes vorhandenen virtuellen Prozessors wird in seinen Anfangswerten wiederhergestellt, und der Status pro virtueller Prozessor, z. B. ausstehendes Anhalten, Abbrechen und Verteilerbenachrichtigungsstatus, wird gelöscht.

Um die Zurücksetzung durchzuführen, blockiert die Funktion alle virtuellen Prozessoren der Partition und fixiert die Partitionszeit; Die Zeit wird erneut aufgetaut, wenn ein virtueller Prozessor als Nächstes ausgeführt wird. Vorhandene virtuelle Prozessoren werden anstelle von Löschungen neu initialisiert, sodass die Anzahl der virtuellen Prozessoren und die konfigurierten Eigenschaften der Partition über die Zurücksetzung beibehalten werden.

Durch das Zurücksetzen einer Partition werden seine GPA-Zuordnungen (Guest Physical Address) nicht entfernt oder der Inhalt des Sicherungsspeichers geändert, der mit WHvMapGpaRange.

Anforderungen

Siehe auch

• WHvCreatePartition
• WHvSetupPartition
• WHvDeletePartition
• Windows Hypervisor-Plattform-API-Definitionen