VDS_DISK_PROP 구조체(vds.h)
[Windows 8 및 Windows Server 2012 가상 디스크 서비스 COM 인터페이스는 Windows Storage 관리 API로 대체됩니다.]
디스크 개체의 속성을 정의합니다.
구문
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;
멤버
id
디스크 개체의 GUID입니다.
status
VDS_DISK_STATUS 열거된 실제 디스크의 가용성입니다. VDS 서비스가 디스크에 대한 핸들을 열 수 없는 경우 이 멤버를 VDS_DS_UNKNOWN 설정합니다.
ReserveMode
이 멤버는 나중에 사용하도록 예약되어 있습니다.
health
디스크의 상태를 지정하는 VDS_HEALTH 열거형 값입니다. 다음은 이 멤버에 대한 유효한 값입니다.
VDS_H_UNKNOWN (0)
VDS_H_HEALTHY (1)
VDS_H_FAILING (4)
VDS_H_FAILED (8)
dwDeviceType
Winioctl.h에 정의된 디바이스 유형으로, 다음과 같은 유형이 포함됩니다.
dwMediaType
STORAGE_MEDIA_TYPE 열거된 미디어 형식입니다. 기본 및 동적 디스크는 FixedMedia 열거자에 매핑됩니다. 자세한 내용은 STORAGE_MEDIA_TYPE 참조하세요.
ullSize
디스크 크기(바이트)입니다. 디스크의 최대 볼륨 크기를 확인하려면 IVdsDisk3::QueryFreeExtents 를 호출하고 모든 사용 가능한 익스텐트의 크기를 추가합니다.
ulBytesPerSector
각 섹터의 바이트 수입니다.
ulSectorsPerTrack
각 트랙의 섹터 수입니다.
ulTracksPerCylinder
각 실린더의 트랙 수입니다.
ulFlags
다양한 디스크 특성을 지정하는 VDS_DISK_FLAG 열거형 값의 비트 마스크입니다.
BusType
VDS_STORAGE_BUS_TYPE 열거된 입력/출력 버스 형식입니다.
PartitionStyle
파티션 형식을 지정하는 VDS_PARTITION_STYLE 열거형 값입니다. 이 구성원은 노조에 대한 비범죄자입니다.
dwSignature
PartitionStyle이 VDS_PST_MBR 경우 사용됩니다(1). MBR 파티션에 대한 서명입니다. 이 값은 고유하지 않습니다.
DiskGuid
PartitionStyle이 VDS_PST_GPT 경우 사용됩니다(2). 디스크의 GUID입니다. 또한 각 GPT 파티션에는 자체 GUID가 있습니다. ( VDS_PARTITION_INFO_GPT 참조하세요.)
pwszDiskAddress
포트NNN 경로 NNN 대상 NNN Lun NNN형식의 SCSI와 유사한 디스크의 주소입니다. 여기서 NNN은 하나 이상의 숫자입니다.
SCSI 디스크, IDE 디스크 및 파이버 채널 디스크에는 이러한 주소가 있을 수 있습니다. USB 및 1394 디스크는 주소 형식이 다르며 저장되지 않습니다.
이 멤버는 선택 사항이며 사용할 수 있는 값이 없는 경우 NULL 일 수 있습니다. NULL이 아닌 경우 해당 길이는 22WCHAR보다 크거나 같아야 하며 필요한 NULL 종결자를 포함하여 64WCHAR보다 작거나 같아야 합니다. IVdsDisk::GetProperties를 호출하여 VDS_DISK_PROP 구조를 수신하는 애플리케이션은 이 멤버가 NULL인지 확인해야 합니다.
pwszName
CreateFile 함수를 사용하여 만든 개체에 대한 핸들을 여는 데 사용되는 이름입니다. 예: \\?\PhysicalDrive2
pwszFriendlyName
플러그 앤 플레이 관리자가 반환한 이름입니다. 이 이름은 플러그 앤 플레이 관리자가 Windows 레지스트리에서 유지 관리합니다(예: "SEAGATE ST34573N SCSI 디스크 디바이스").
pwszAdaptorName
이 디스크가 연결된 어댑터의 이름입니다. 플러그 앤 플레이 Manager는 Windows 레지스트리에서 유지 관리되는 이름(예: "Adaptec AHA-2940U2W - Ultra2 SCSI")을 반환합니다.
pwszDevicePath
플러그 앤 플레이 관리자가 반환한 문자열입니다. 플러그 앤 플레이 관리자는 디바이스 경로를 사용하여 컴퓨터에서 디바이스를 고유하게 식별합니다. 자세한 내용은 SP_DEVICE_INTERFACE_DETAIL_DATA_W.
설명
IVdsDisk::GetProperties 메서드는 이 구조체의 값을 반환하여 디스크 개체의 속성을 보고합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista[데스크톱 앱 전용] |
| 지원되는 최소 서버 | Windows Server 2003[데스크톱 앱 전용] |
| 머리글 | vds.h |