VDS_DISK_PROP 구조체(vds.h)

아티클
03/08/2023

[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 설정합니다.

참고 포함된 팩의 상태가 VDS_PS_OFFLINE 경우에도 이 멤버를 VDS_DS_ONLINE 수 있습니다.

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