Método IVdsDiskPartitionMF::FormatPartitionEx (vds.h)

[A partir de Windows 8 y Windows Server 2012, la interfaz COM del servicio de disco virtual se sustituye por la API de administración de almacenamiento de Windows.]

Da formato a una partición existente de OEM, ESP o desconocida.

Sintaxis

HRESULT FormatPartitionEx(
  [in]  ULONGLONG ullOffset,
  [in]  LPWSTR    pwszFileSystemTypeName,
  [in]  USHORT    usFileSystemRevision,
  [in]  ULONG     ulDesiredUnitAllocationSize,
  [in]  LPWSTR    pwszLabel,
  [in]  BOOL      bForce,
  [in]  BOOL      bQuickFormat,
  [in]  BOOL      bEnableCompression,
  [out] IVdsAsync **ppAsync
);

Parámetros

[in] ullOffset

Desplazamiento de bytes de la partición desde el principio del disco. Este desplazamiento debe ser el desplazamiento del inicio de una partición.

[in] pwszFileSystemTypeName

Cadena Unicode terminada en NULL que contiene el nombre del sistema de archivos con el que se va a dar formato a la partición. Debe ser NULL o uno de los siguientes: "NTFS", "FAT","FAT32", "UDF" o "EXFAT". Si este parámetro es NULL, se usa un valor predeterminado.

[in] usFileSystemRevision

Revisión del sistema de archivos, si existe. Este miembro se expresa como un número decimal con código binario de 16 bits, donde un separador decimal está implícito entre los dígitos segundo y tercero. Por ejemplo, un valor de 0x0250 indica la revisión 2.50.

[in] ulDesiredUnitAllocationSize

Tamaño de la unidad de asignación para el sistema de archivos, en bytes. El valor debe ser una potencia de 2. Si el valor es 0, se usará una unidad de asignación predeterminada determinada por el tipo de sistema de archivos. El intervalo de unidades de asignación depende del sistema de archivos.

[in] pwszLabel

Cadena Unicode terminada en null para asignar al nuevo sistema de archivos para el volumen. El tamaño máximo de etiqueta depende del sistema de archivos.

[in] bForce

Boolean que determina si se fuerza un formato de sistema de archivos, independientemente de si la partición está en uso.

[in] bQuickFormat

Boolean que determina si un volumen del sistema de archivos tiene formato rápido. Un formato rápido no comprueba cada sector del volumen.

[in] bEnableCompression

Boolean que determina si se creará un sistema de archivos con la compresión habilitada.

[out] ppAsync

Puntero a una interfaz IVdsAsync que al finalizar correctamente recibe la interfaz IVdsAsync para supervisar y controlar esta operación. Los autores de llamadas deben liberar la interfaz recibida cuando terminen con ella.

Valor devuelto

Este método puede devolver valores HRESULT estándar, como E_INVALIDARG o E_OUTOFMEMORY, y valores devueltos específicos de VDS. También puede devolver códigos de error del sistema convertidos mediante la macro HRESULT_FROM_WIN32 . Los errores pueden originarse en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los valores devueltos posibles se incluyen los siguientes.

Además, la interfaz IVdsAsync puede devolver las siguientes advertencias relacionadas y códigos de error.

Comentarios

Este método solo da formato a las particiones OEM, ESP y desconocidas. Para otras particiones, debe dar formato al volumen correspondiente mediante el método IVdsVolumeMF::Format o IVdsVolumeMF2::FormatEx . Tenga en cuenta que las particiones OEM, ESP y desconocidas no se exponen como volúmenes y, por lo tanto, no se pueden dar formato con Format o FormatEx.

Este método no se puede usar para dar formato a medios extraíbles.

Si una partición OEM tiene el formato FAT o FAT32, el tipo de partición no cambia. Si tiene formato NTFS, el tipo de partición cambia a PARTITION_IFS (0x07). Para obtener información sobre los tipos de partición, consulte CREATE_PARTITION_PARAMETERS.

Para obtener más información sobre los límites del sistema de archivos, como el tamaño mínimo y máximo de la unidad de asignación (también denominado tamaño de clúster), consulte Referencia técnica ntfs y Referencia técnica fat.

Requisitos

Consulte también

IVdsAdvancedDisk::FormatPartition

IVdsDiskPartitionMF