estructura VDS_VOLUME_PROP2 (vds.h)

Artículo
03/08/2023

[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.]

Define las propiedades de un objeto de volumen. Esta estructura es idéntica a la estructura de VDS_VOLUME_PROP , salvo que también incluye los GUID de volumen.

Sintaxis

typedef struct _VDS_VOLUME_PROP2 {
  VDS_OBJECT_ID        id;
  VDS_VOLUME_TYPE      type;
  VDS_VOLUME_STATUS    status;
  VDS_HEALTH           health;
  VDS_TRANSITION_STATE TransitionState;
  ULONGLONG            ullSize;
  ULONG                ulFlags;
  VDS_FILE_SYSTEM_TYPE RecommendedFileSystemType;
  ULONG                cbUniqueId;
  LPWSTR               pwszName;
  BYTE                 *pUniqueId;
} VDS_VOLUME_PROP2, *PVDS_VOLUME_PROP2;

Miembros

id

GUID del volumen.

type

Valor de enumeración VDS_VOLUME_TYPE que especifica el tipo de volumen. Los tipos de volumen son simples, distribuidos, seccionados (RAID-0), reflejados o seccionados con paridad (RAID-5).

status

Valor de enumeración VDS_VOLUME_STATUS que especifica el estado del volumen.

health

Valor de enumeración VDS_HEALTH que especifica el estado de mantenimiento del volumen.

TransitionState

Valor de enumeración VDS_TRANSITION_STATE que especifica el estado de transición del volumen.

ullSize

Tamaño del volumen, en bytes.

ulFlags

Máscara de bits de VDS_VOLUME_FLAG valores de enumeración que describen el volumen.

RecommendedFileSystemType

Valor de enumeración VDS_FILE_SYSTEM_TYPE que especifica el sistema de archivos preferido para el volumen. Debe ser uno de los siguientes: VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32, VDS_FST_UDF, VDS_FST_CDFS o VDS_FST_UNKNOWN.

cbUniqueId

Longitud de la matriz de bytes a la que apunta el miembro pUniqueId .

pwszName

Nombre que se usó para abrir un identificador para el volumen con la función CreateFile . Por ejemplo, \?\GLOBALROOT\Device\HarddiskVolume1.

pUniqueId

Matriz de bytes que contiene el identificador único del volumen.

Comentarios

El método IVdsVolume2::GetProperties2 devuelve esta estructura para informar de las propiedades de un objeto de volumen.

Cuando un volumen está sin conexión, la marca de VDS_VF_PERMANENTLY_DISMOUNTED se establece en el miembro ulFlags de la estructura VDS_VOLUME_PROP2 y el valor de estado del volumen de VDS_VS_OFFLINE también se establece en el miembro de estado de esta estructura.

En el caso de los volúmenes GPT y dinámicos, el identificador único al que apunta el miembro pUniqueId es único globalmente.

En el caso de las unidades de medios extraíbles, el volumen existe y tiene su propio identificador único, incluso si no hay ningún medio en el dispositivo. Si un volumen tiene formato en medios extraíbles, ese volumen tiene su propio identificador único. Para obtener más información, vea Admitir solicitudes del Administrador de montaje en un controlador de clase de almacenamiento.

El formato del identificador único puede variar entre diferentes tipos de dispositivos y volúmenes. En el caso de los volúmenes básicos en discos MBR, el identificador único se basa en la firma del disco y el desplazamiento de partición. Dado que la firma de disco y el desplazamiento de partición son valores DWORD, no se puede garantizar que el identificador único sea globalmente único en todos los equipos.

Si cambia la firma del disco, el identificador único del volumen también cambia. Los cambios de firma de disco suelen producirse como resultado de una colisión durante la clonación de disco.

Tenga en cuenta que un identificador único no es el mismo que una ruta de acceso GUID de volumen. Para buscar las rutas de acceso GUID de volumen de un volumen, use el método IVdsVolumeMF3::QueryVolumeGuidPathnames .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado	vds.h