VDS_DRIVE_PROP2 구조체(vds.h)

아티클
03/08/2023

[Windows 8 및 Windows Server 2012 가상 디스크 서비스 COM 인터페이스는 Windows Storage 관리 API로 대체됩니다.]

드라이브 개체의 속성을 정의합니다. 이 구조체는 엔클로저 번호, 버스 유형 및 스핀들 속도를 멤버로 포함한다는 점을 제외하고 VDS_DRIVE_PROP 구조체 와 동일합니다.

구문

typedef struct _VDS_DRIVE_PROP2 {
  VDS_OBJECT_ID        id;
  ULONGLONG            ullSize;
  LPWSTR               pwszFriendlyName;
  LPWSTR               pwszIdentification;
  ULONG                ulFlags;
  VDS_DRIVE_STATUS     status;
  VDS_HEALTH           health;
  SHORT                sInternalBusNumber;
  SHORT                sSlotNumber;
  ULONG                ulEnclosureNumber;
  VDS_STORAGE_BUS_TYPE busType;
  ULONG                ulSpindleSpeed;
} VDS_DRIVE_PROP2, *PVDS_DRIVE_PROP2;

멤버

id

드라이브 개체의 GUID입니다.

ullSize

드라이브 크기(바이트)입니다.

pwszFriendlyName

드라이브 이름을 포함하는 NULL로 끝나는 와이드 문자열입니다.

pwszIdentification

드라이브 식별자를 포함하는 NULL로 종료된 와이드 문자열입니다.

ulFlags

의 비트 마스크
VDS_DRIVE_FLAG 열거형 값입니다.

status

A
드라이브의 상태 지정하는 VDS_DRIVE_STATUS 열거형 값입니다.

health

드라이브의 상태 상태 지정하는 VDS_HEALTH 열거형 값입니다. 다음은 이 멤버에 대한 유효한 값입니다.

Windows Server 2008, Windows Vista 및 Windows Server 2003: VDS_H_REPLACED 및 VDS_H_PENDING_FAILURE 지원되지 않습니다.

VDS_H_UNKNOWN(0)

VDS_H_HEALTHY (1)

VDS_H_FAILED (8)

VDS_H_REPLACED (9)

VDS_H_PENDING_FAILURE(10)

sInternalBusNumber

드라이브가 연결된 버스의 수입니다. 이 숫자는 하위 시스템 내에서 버스를 고유하게 식별하는 구현자가 할당한 값입니다. 하위 시스템에 포함된 버스 수에 의해 제한되지 않으며 VDS_SUB_SYSTEM_PROP 구조체의 sNumberOfInternalBuses 멤버 값과 관련이 없습니다.

sSlotNumber

드라이브가 차지하는 슬롯 수입니다. 이 숫자는 버스 내의 슬롯을 고유하게 식별하는 구현자가 할당한 값입니다. 버스에 포함된 슬롯 수로 제한되지 않으며 VDS_SUB_SYSTEM_PROP 구조체의 sMaxNumberOfSlotsEachBus 멤버 값과 관련이 없습니다.

ulEnclosureNumber

드라이브를 포함하는 인클로저의 수입니다. ULONG_MAX 값은 이 숫자가 드라이브에 대해 정의되지 않음을 나타냅니다. 일부 엔클로저 번호 매기기 체계는 0부터 시작하므로 0은 이 멤버에 유효한 값입니다. 이 멤버는 IVdsSubSystem2::GetDrive2 메서드의 ulEnclosureNumber 매개 변수에 해당합니다.

busType

드라이브의 버스 유형을 지정하는 VDS_STORAGE_BUS_TYPE 값입니다. 값이 0이면 버스 유형을 알 수 없음을 의미합니다.

ulSpindleSpeed

RPM에서 드라이브의 스핀들 속도입니다. 이 멤버의 기본값은 0입니다. 값이 0이면 스핀들 속도를 알 수 없음을 의미합니다. 값 1은 드라이브에 회전 미디어가 없음을 의미합니다. (예를 들어, 반도체 드라이브일 수 있습니다.)

설명

이 구조체는 IVdsDrive2::GetProperties2 메서드에서 드라이브 개체의 속성을 반환하는 데 사용됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
머리글	vds.h

Share via