Partager via

FSCTL_EXTEND_VOLUME IOCTL (winioctl.h)

  • Article

Augmente la taille d’un volume monté.

Pour effectuer cette opération, appelez la fonction DeviceIoControl avec les paramètres suivants.

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
);

Remarques

Ce code de contrôle est pris en charge sur les systèmes de fichiers NTFS, RAW et ReFS.

Ce code de contrôle ne peut pas être utilisé pour réduire la taille d’un volume. La nouvelle taille de volume doit être d’au moins un cluster supérieur à la taille de volume précédente. La partition sous-jacente doit avoir suffisamment de secteurs pour contenir le volume étendu. Si ce n’est pas le cas, vous pouvez utiliser IOCTL_DISK_GROW_PARTITION si l’appareil sous-jacent dispose de suffisamment d’espace disponible.

Vous pouvez étendre un volume en direct et le volume peut être ouvert pour le partage pendant l’opération d’extension.

Vous n’avez pas besoin de verrouiller un volume que vous étendez, ni d’arrêter d’autres applications ou services pendant l’opération d’extension.

Dans Windows 8 et Windows Server 2012, ce code est pris en charge par les technologies suivantes.

Technologie Prise en charge
Protocole Server Message Block (SMB) 3.0 No
Basculement transparent SMB 3.0 (TFO) No
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) No
Système de fichiers du volume partagé de cluster (CsvFS) Oui
Système de fichiers résilient (ReFS) Oui

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
En-tête winioctl.h (inclure Windows.h)

Voir aussi