Share via

FSCTL_EXTEND_VOLUME IOCTL (winioctl.h)

  • Artigo

Aumenta o tamanho de um volume montado.

Para executar essa operação, chame a função DeviceIoControl com os parâmetros a seguir.

BOOL DeviceIoControl(
  (HANDLE) hDevice,             // handle to device
  FSCTL_EXTEND_VOLUME,          // dwIoControlCode
  (LPVOID) lpInBuffer,          // input buffer
  (DWORD) nInBufferSize,        // size of input buffer
  NULL,                         // lpOutBuffer
  0,                            // nOutBufferSize
  (LPDWORD) lpBytesReturned,    // number of bytes returned
  (LPOVERLAPPED) lpOverlapped   // OVERLAPPED structure
);

Comentários

Esse código de controle tem suporte em sistemas de arquivos NTFS, RAW e ReFS.

Esse código de controle não pode ser usado para reduzir o tamanho de um volume. O novo tamanho do volume deve ser pelo menos um cluster maior que o tamanho do volume anterior. A partição subjacente deve ter setores suficientes para conter o volume estendido. Caso contrário, IOCTL_DISK_GROW_PARTITION poderá ser usado se o dispositivo subjacente tiver espaço suficiente disponível.

Você pode estender um volume dinâmico e o volume pode ser aberto para compartilhamento durante a operação de extensão.

Você não precisa bloquear um volume que está estendendo, nem precisa desligar outros aplicativos ou serviços durante a operação de extensão.

Em Windows 8 e Windows Server 2012, esse código é compatível com as tecnologias a seguir.

Tecnologia Com suporte
Protocolo SMB (SMB) 3.0 No
TFO (Failover transparente) do SMB 3.0 No
SMB 3.0 com compartilhamentos de arquivos de expansão (SO) No
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) Sim
ReFS (Sistema de Arquivos Resiliente) Sim

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho winioctl.h (inclua Windows.h)

Confira também