Compartilhar via

Método IVdsVolumeMF::Format (vds.h)

  • Artigo

[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]

Formata um sistema de arquivos no volume atual.

Sintaxe

HRESULT Format(
  [in]  VDS_FILE_SYSTEM_TYPE type,
  [in]  LPWSTR               pwszLabel,
  [in]  DWORD                dwUnitAllocationSize,
  [in]  BOOL                 bForce,
  [in]  BOOL                 bQuickFormat,
  [in]  BOOL                 bEnableCompression,
  [out] IVdsAsync            **ppAsync
);

Parâmetros

[in] type

Um VDS_FILE_SYSTEM_TYPE valor de enumeração que especifica o sistema de arquivos a ser usado. Deve ser um dos seguintes: VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32 ou VDS_FST_UDF.

[in] pwszLabel

Uma cadeia de caracteres que representa o rótulo do sistema de arquivos.

[in] dwUnitAllocationSize

O tamanho da unidade de alocação para o sistema de arquivos em bytes, que geralmente está entre 512 e 65536.

[in] bForce

Se TRUE, o sistema de arquivos será formatado incondicionalmente mesmo enquanto estiver em uso; caso contrário, a operação falhará.

[in] bQuickFormat

Se TRUE, o VDS executará um formato rápido (ele não verificará cada setor no volume).

[in] bEnableCompression

Se TRUE, a compactação será habilitada no sistema de arquivos recém-formatado. A compactação é um recurso do NTFS e é ignorada para FAT e FAT32.

[out] ppAsync

O endereço de um ponteiro de interface IVdsAsync , que o VDS inicializa no retorno. Os chamadores devem liberar a interface . Use esse ponteiro para cancelar, aguardar ou consultar o status da operação.

Retornar valor

Esse método pode retornar valores HRESULT padrão, como E_INVALIDARG ou E_OUTOFMEMORY e valores retornados específicos do VDS. Ele também pode retornar códigos de erro do sistema convertidos usando a macro HRESULT_FROM_WIN32 . Os erros podem ser originados do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os possíveis valores retornados incluem o seguinte.

Código/valor de retorno Descrição
S_OK
 O sistema de arquivos foi formatado com êxito.
VDS_E_OPERATION_DENIED
0x8004240AL
 A operação será negada se o chamador tentar formatar os volumes de sistema, inicialização, carimbo de falha, hibernação ou pagefile.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 O volume falhou.
VDS_E_PACK_OFFLINE
0x80042444L
 O pacote que contém o volume não está acessível. Todos os volumes em um pacote offline são inacessíveis.
 

Além disso, a interface IVdsAsync pode retornar os seguintes avisos relacionados e códigos de erro.

Código/valor de retorno Descrição
VDS_S_VOLUME_COMPRESS_FAILED
0x00042443L
 O sistema de arquivos é formatado, mas não compactado.
VDS_E_INCOMPATIBLE_FILE_SYSTEM
0x80042425L
 O sistema de arquivos é incompatível.
VDS_E_INCOMPATIBLE_MEDIA
0x80042426L
 A mídia é incompatível.
VDS_E_ACCESS_DENIED
0x80042427L
 Acesso negado.
VDS_E_MEDIA_WRITE_PROTECTED
0x80042428L
 A mídia é protegida por gravação.
VDS_E_BAD_LABEL
0x80042429L
 O rótulo não é válido.
VDS_E_CANT_QUICK_FORMAT
0x8004242AL
 O volume não pode ser formatado rapidamente.
VDS_E_IO_ERROR
0x8004242BL
 Ocorreu um erro de E/S durante o formato.
VDS_E_VOLUME_TOO_SMALL
0x8004242CL
 O tamanho do volume é muito pequeno para ser formatado.
VDS_E_VOLUME_TOO_BIG
0x8004242DL
 O tamanho do volume é muito grande para ser formatado.
VDS_E_CLUSTER_SIZE_TOO_SMALL
0x8004242EL
 O tamanho do cluster é muito pequeno para permitir a formatação.
VDS_E_CLUSTER_SIZE_TOO_BIG
0x8004242FL
 O tamanho do cluster é muito grande para permitir a formatação.
VDS_E_CLUSTER_COUNT_BEYOND_32BITS
0x80042430L
 O número de clusters é muito grande para representar como um inteiro de 32 bits.
VDS_E_INVALID_FS_TYPE
0x80042561L
 O valor do parâmetro de tipo não foi VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32 ou VDS_FST_UDF.
VDS_E_CANT_INVALIDATE_FVE
0x80042592L
 Não foi possível desabilitar a criptografia do BitLocker para o volume.

Comentários

Para criar um volume de inicialização em um disco dinâmico, você deve chamar IVdsVolume::SetFlags para definir o sinalizador VDS_VF_INSTALLABLE antes de chamar Format para formatar o volume.

Se uma partição OEM for formatada como FAT ou FAT32, o tipo de partição não será alterado. Se for formatado com NTFS, o tipo de partição será alterado para PARTITION_IFS (0x07). Para obter informações sobre tipos de partição, consulte CREATE_PARTITION_PARAMETERS.

Se esse método for chamado para um volume protegido pela criptografia de volume completo do BitLocker, a criptografia BitLocker será desabilitada para o volume até que o usuário a habilite novamente.

Para obter mais informações sobre limites do sistema de arquivos, como tamanho mínimo e máximo da unidade de alocação (também chamado de tamanho do cluster), consulte Referência técnica do NTFS e Referência técnica de FAT.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vds.h
Biblioteca Uuid.lib

Confira também

IVdsAsync

IVdsVolumeMF

VDS_FILE_SYSTEM_TYPE