VDS_DISK_PROP Struktur (vds.h)
[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.
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 |