VDS_DISK_PROP estructura (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 disco.

Sintaxis

typedef struct _VDS_DISK_PROP {
  VDS_OBJECT_ID        id;
  VDS_DISK_STATUS      status;
  VDS_LUN_RESERVE_MODE ReserveMode;
  VDS_HEALTH           health;
  DWORD                dwDeviceType;
  DWORD                dwMediaType;
  ULONGLONG            ullSize;
  ULONG                ulBytesPerSector;
  ULONG                ulSectorsPerTrack;
  ULONG                ulTracksPerCylinder;
  ULONG                ulFlags;
  VDS_STORAGE_BUS_TYPE BusType;
  VDS_PARTITION_STYLE  PartitionStyle;
  union {
    DWORD dwSignature;
    GUID  DiskGuid;
  };
  LPWSTR               pwszDiskAddress;
  LPWSTR               pwszName;
  LPWSTR               pwszFriendlyName;
  LPWSTR               pwszAdaptorName;
  LPWSTR               pwszDevicePath;
} VDS_DISK_PROP, *PVDS_DISK_PROP;

Members

id

GUID del objeto de disco.

status

La disponibilidad de un disco físico enumerado por VDS_DISK_STATUS. Si el servicio VDS no puede abrir un identificador en el disco, establece este miembro en VDS_DS_UNKNOWN.

Nota Este miembro puede ser VDS_DS_ONLINE, incluso si el estado del paquete contenedor es VDS_PS_OFFLINE.

ReserveMode

Este miembro se reserva para uso futuro.

health

Valor de enumeración VDS_HEALTH que especifica el estado de mantenimiento del disco. A continuación se muestran los valores válidos para este miembro.

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_FAILING (4)

VDS_H_FAILED (8)

dwDeviceType

El tipo de dispositivo definido en Winioctl.h, que incluye los siguientes tipos entre otros:

dwMediaType

Tipo de medio enumerado por STORAGE_MEDIA_TYPE. Los discos básicos y dinámicos se asignan al enumerador FixedMedia . Para obtener más información, consulte STORAGE_MEDIA_TYPE.

ullSize

Tamaño del disco en bytes. Para determinar el tamaño máximo del volumen de un disco, llame a IVdsDisk3::QueryFreeExtents y agregue los tamaños de todas las extensiones libres.

ulBytesPerSector

Número de bytes de cada sector.

ulSectorsPerTrack

Número de sectores de cada pista.

ulTracksPerCylinder

Número de pistas en cada cilindro.

ulFlags

Máscara de bits de VDS_DISK_FLAG valores de enumeración que especifican varios atributos de disco.

BusType

Los tipos de bus de entrada y salida enumerados por VDS_STORAGE_BUS_TYPE.

PartitionStyle

Valor de enumeración VDS_PARTITION_STYLE que especifica el tipo de partición. Este miembro es el discriminante para la unión.

dwSignature

Se usa si PartitionStyle es VDS_PST_MBR (1). Firma de la partición MBR. No se garantiza que este valor sea único.

DiskGuid

Se usa si PartitionStyle es VDS_PST_GPT (2). GUID del disco. Además, cada partición GPT tiene su propio GUID. (Consulte VDS_PARTITION_INFO_GPT).

pwszDiskAddress

La dirección de un disco similar a SCSI en el formatoNNNruta de accesoNNNde destinoNNN de destinoNNN, donde NNN es uno o varios dígitos.

Los discos SCSI, los discos IDE y los discos de canal de fibra pueden tener esta dirección. Los discos USB y 1394 tienen formatos de dirección diferentes y no se almacenan.

Este miembro es opcional y puede ser NULL si no hay ningún valor disponible. Si no es NULL, su longitud debe ser mayor o igual que 22 WCHAR y menor o igual que 64 WCHAR, incluido el terminador NULL necesario. Las aplicaciones que reciben la estructura de VDS_DISK_PROP mediante una llamada a IVdsDisk::GetProperties deben comprobar si este miembro es NULL.

pwszName

Nombre usado para abrir un identificador en un objeto creado mediante la función CreateFile . Por ejemplo: \\?\PhysicalDrive2

pwszFriendlyName

Nombre devuelto por el administrador de Plug and Play. El administrador de Plug and Play mantiene este nombre en el Registro de Windows, por ejemplo: "DISPOSITIVO de disco SCSI SEAGATE ST34573N".

pwszAdaptorName

Nombre del adaptador al que está conectado este disco. El administrador de Plug and Play devuelve el nombre, que se mantiene en el Registro de Windows, por ejemplo: "Adaptec AHA-2940U2W - Ultra2 SCSI".

pwszDevicePath

Cadena devuelta por el administrador de Plug and Play. El administrador de Plug and Play usa la ruta de acceso del dispositivo para identificar de forma única un dispositivo en un equipo. Para obtener más información, consulte SP_DEVICE_INTERFACE_DETAIL_DATA_W.

Comentarios

El método IVdsDisk::GetProperties devuelve el valor de esta estructura para notificar las propiedades de un objeto de disco.

Requisitos


Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	vds.h