IOCTL_DISK_RESET_SNAPSHOT_INFO IOCTL (ntdddisk.h)

  • Artigo

Limpa todas as informações de instantâneo baseadas em hardware do VSS (serviço de cópia de sombra de volume) do disco. Um instantâneo também é conhecido como uma cópia de sombra. Essa solicitação está disponível no Windows Vista e em versões posteriores dos sistemas operacionais Windows. O chamador deve estar em execução em IRQL = PASSIVE_LEVEL.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Nenhum.

Comprimento do buffer de entrada

Nenhum.

Buffer de saída

Nenhum.

Comprimento do buffer de saída

Nenhum.

Bloco de status

O membro Informações é definido como zero. O membro Status será definido como STATUS_SUCCESS se a operação tiver sido bem-sucedida. Caso contrário, o membro Status será definido como o código de erro apropriado.

Comentários

Esse código de controle de E/S pode ser emitido de um driver no modo kernel ou de um aplicativo de modo de usuário. Quando esse código de controle de E/S é emitido de um driver no modo kernel, o chamador fornece um IRP (Pacote de Solicitação de E/S) que contém uma estrutura de dados IO_STATUS_BLOCK. Essa estrutura de dados é usada para retornar informações de erro ao chamador. Quando esse código de controle de E/S é emitido de um aplicativo de modo de usuário com a rotina DeviceIocontrol , o chamador pode obter informações de erro chamando a rotina GetLastError .

O disco cujo identificador é usado quando esse IOCTL é emitido pode estar no estado offline quando o IOCTL é emitido. Se o disco for colocado no estado offline usando o snap-in do MMC (Console de Gerenciamento da Microsoft) do gerenciador de discos, o disco terá seu atributo somente leitura definido, o que fará com que esse IOCTL falhe. No entanto, se o utilitário de partição de disco (Diskpart.exe) for usado para colocar o disco no estado offline, o atributo somente leitura para o disco não será definido. Por esse motivo, é melhor usar o utilitário de partição de disco para colocar um disco no estado offline.

Nota Um efeito colateral do uso desse IOCTL é que as ferramentas de Gerenciamento de Disco podem relatar uma partição adicional do tipo "UNKNOWN" em discos GPT. Essa partição de 256 quilobytes é criada pela operação IOCTL e é uma partição instantâneo usada no processo de restauração. Essa partição é esperada e pode ser ignorada pelos administradores do sistema.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows Vista.
Cabeçalho ntdddisk.h (inclua Ntdddisk.h)
IRQL PASSIVE_LEVEL