VDS_DISK_PROP Struktur (vds.h)

Artikel
03/08/2023

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]

Definiert die Eigenschaften eines Datenträgerobjekts.

Syntax

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;

Member

id

Die GUID des Datenträgerobjekts.

status

Die Verfügbarkeit eines physischen Datenträgers, der von VDS_DISK_STATUS aufgelistet wird. Wenn der VDS-Dienst kein Handle für den Datenträger öffnen kann, legt er diesen Member auf VDS_DS_UNKNOWN fest.

Hinweis Dieses Element kann VDS_DS_ONLINE werden, auch wenn der Status der enthaltenden Packung VDS_PS_OFFLINE ist.

ReserveMode

Dieses Element ist für die zukünftige Verwendung reserviert.

health

Ein VDS_HEALTH Enumerationswert, der den Integritätszustand des Datenträgers angibt. Im Folgenden sind die gültigen Werte für dieses Element aufgeführt.

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_FAILING (4)

VDS_H_FAILED (8)

dwDeviceType

Der in Winioctl.h definierte Gerätetyp, der unter anderem die folgenden Typen umfasst:

dwMediaType

Ein Von STORAGE_MEDIA_TYPE aufgelisteter Medientyp. Einfache und dynamische Datenträger werden dem FixedMedia-Enumerator zugeordnet. Weitere Informationen finden Sie unter STORAGE_MEDIA_TYPE.

ullSize

Die Größe des Datenträgers in Bytes. Um die maximale Volumegröße für einen Datenträger zu ermitteln, rufen Sie IVdsDisk3::QueryFreeExtents auf, und fügen Sie die Größen aller freien Erweiterungen hinzu.

ulBytesPerSector

Die Anzahl der Bytes in jedem Sektor.

ulSectorsPerTrack

Die Anzahl der Sektoren in den einzelnen Strecken.

ulTracksPerCylinder

Die Anzahl der Spuren in jedem Zylinder.

ulFlags

Eine Bitmaske von VDS_DISK_FLAG Enumerationswerte, die verschiedene Datenträgerattribute angeben.

BusType

Die von VDS_STORAGE_BUS_TYPE aufgelisteten Ein-/Ausgabebustypen.

PartitionStyle

Ein VDS_PARTITION_STYLE Enumerationswert, der den Partitionstyp angibt. Dieses Mitglied ist das Diskriminant für die Gewerkschaft.

dwSignature

Wird verwendet, wenn PartitionStyleVDS_PST_MBR (1) ist. Die Signatur für die MBR-Partition. Dieser Wert ist nicht garantiert eindeutig.

DiskGuid

Wird verwendet, wenn PartitionStyleVDS_PST_GPT (2) ist. Die GUID für den Datenträger. Darüber hinaus verfügt jede GPT-Partition über eine eigene GUID. (Siehe VDS_PARTITION_INFO_GPT.)

pwszDiskAddress

Die Adresse eines SCSI-ähnlichen Datenträgers im PortNNNPfadNNNZielNNNLunNNN Format, wobei NNN eine oder mehrere Ziffern ist.

SCSI-Datenträger, IDE-Datenträger und Fibre Channel-Datenträger können eine solche Adresse aufweisen. USB- und 1394-Datenträger haben unterschiedliche Adressformate und werden nicht gespeichert.

Dieser Member ist optional und kann NULL sein, wenn kein Wert verfügbar ist. Wenn es nicht NULL ist, muss die Länge größer oder gleich 22 WCHAR und kleiner als oder gleich 64 WCHAR sein, einschließlich des erforderlichen NULL-Abschlusszeichens . Anwendungen, die die VDS_DISK_PROP-Struktur empfangen, indem sie IVdsDisk::GetProperties aufrufen, müssen überprüfen, ob dieser Member NULL ist.

pwszName

Der Name, der verwendet wird, um ein Handle für ein Objekt zu öffnen, das mit der CreateFile-Funktion erstellt wurde. Beispiel: \\?\PhysicalDrive2

pwszFriendlyName

Der vom Plug & Play-Manager zurückgegebene Name. Dieser Name wird in der Windows-Registrierung vom Plug & Play Manager verwaltet, z. B. "SEAGATE ST34573N SCSI Disk Device".

pwszAdaptorName

Der Name des Adapters, an den dieser Datenträger angefügt ist. Der Plug & Play-Manager gibt den Namen zurück, der in der Windows-Registrierung beibehalten wird, z. B. "Adaptec AHA-2940U2W - Ultra2 SCSI".

pwszDevicePath

Die vom Plug & Play-Manager zurückgegebene Zeichenfolge. Der Plug & Play-Manager verwendet den Gerätepfad, um ein Gerät auf einem Computer eindeutig zu identifizieren. Weitere Informationen finden Sie unter SP_DEVICE_INTERFACE_DETAIL_DATA_W.

Hinweise

Die IVdsDisk::GetProperties-Methode gibt den Wert dieser Struktur zurück, um die Eigenschaften eines Datenträgerobjekts zu melden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	vds.h