WHvResetPartition

Reinicia uma partição para o seu estado inicial.

Sintaxe

HRESULT
WINAPI
WHvResetPartition(
    _In_ WHV_PARTITION_HANDLE Partition
    );

Parameters

Partition

Handle para o objeto de partição para reiniciar.

Valor de retorno

Se a função tiver sucesso, o valor de retorno é S_OK.

Se a partição estiver num estado que não permite um reset, a função devolve HRESULT_FROM_WIN32(ERROR_INVALID_STATE).

Remarks

A WHvResetPartition função reinicia a partição, devolvendo os seus processadores virtuais ao estado imediatamente após a partição ter sido configurada com WHvSetupPartition. O estado do registo de cada processador virtual existente é restaurado aos seus valores iniciais, e o estado por processador virtual, como suspensão pendente, cancelamento e estado de notificação de despacho, é limpo.

Para realizar o reset, a função bloqueia todos os processadores virtuais da partição e congela o tempo da partição; O tempo descongela novamente quando um processador virtual é executado novamente. Os processadores virtuais existentes são reinicializados no local em vez de serem eliminados, pelo que o número de processadores virtuais e as propriedades configuradas da partição são preservados ao longo do reset.

Reiniciar uma partição não remove os mapeamentos do seu endereço físico de convidado (GPA) nem altera o conteúdo da memória de backup estabelecida com WHvMapGpaRange.

Requirements

Requirement Value
Windows mínimo suportado Windows 11, versão 21H2 (x64); Windows 11, versão 24H2, build 26100.3915 (Arm64)
Header WinHvPlatform.h
Biblioteca WinHvPlatform.lib
DLL WinHvPlatform.dll
Arquitetura x64, ARM64

Ver também