Método IVdsVolumeMF::Format (vds.h)
[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 |
|---|---|
|
O sistema de arquivos foi formatado com êxito. |
|
A operação será negada se o chamador tentar formatar os volumes de sistema, inicialização, carimbo de falha, hibernação ou pagefile. |
|
O volume falhou. |
|
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 |
|---|---|
|
O sistema de arquivos é formatado, mas não compactado. |
|
O sistema de arquivos é incompatível. |
|
A mídia é incompatível. |
|
Acesso negado. |
|
A mídia é protegida por gravação. |
|
O rótulo não é válido. |
|
O volume não pode ser formatado rapidamente. |
|
Ocorreu um erro de E/S durante o formato. |
|
O tamanho do volume é muito pequeno para ser formatado. |
|
O tamanho do volume é muito grande para ser formatado. |
|
O tamanho do cluster é muito pequeno para permitir a formatação. |
|
O tamanho do cluster é muito grande para permitir a formatação. |
|
O número de clusters é muito grande para representar como um inteiro de 32 bits. |
|
O valor do parâmetro de tipo não foi VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32 ou VDS_FST_UDF. |
|
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 |