다음을 통해 공유


VDS_POOL_ATTRIBUTES 구조체(vdshwprv.h)

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

스토리지 풀의 특성을 정의합니다.

구문

typedef struct _VDS_POOL_ATTRIBUTES {
  ULONGLONG                  ullAttributeMask;
  VDS_RAID_TYPE              raidType;
  VDS_STORAGE_BUS_TYPE       busType;
  LPWSTR                     pwszIntendedUsage;
  BOOL                       bSpinDown;
  BOOL                       bIsThinProvisioned;
  ULONGLONG                  ullProvisionedSpace;
  BOOL                       bNoSinglePointOfFailure;
  ULONG                      ulDataRedundancyMax;
  ULONG                      ulDataRedundancyMin;
  ULONG                      ulDataRedundancyDefault;
  ULONG                      ulPackageRedundancyMax;
  ULONG                      ulPackageRedundancyMin;
  ULONG                      ulPackageRedundancyDefault;
  ULONG                      ulStripeSize;
  ULONG                      ulStripeSizeMax;
  ULONG                      ulStripeSizeMin;
  ULONG                      ulDefaultStripeSize;
  ULONG                      ulNumberOfColumns;
  ULONG                      ulNumberOfColumnsMax;
  ULONG                      ulNumberOfColumnsMin;
  ULONG                      ulDefaultNumberofColumns;
  ULONG                      ulDataAvailabilityHint;
  ULONG                      ulAccessRandomnessHint;
  ULONG                      ulAccessDirectionHint;
  ULONG                      ulAccessSizeHint;
  ULONG                      ulAccessLatencyHint;
  ULONG                      ulAccessBandwidthWeightHint;
  ULONG                      ulStorageCostHint;
  ULONG                      ulStorageEfficiencyHint;
  ULONG                      ulNumOfCustomAttributes;
  VDS_POOL_CUSTOM_ATTRIBUTES *pPoolCustomAttributes;
  BOOL                       bReserved1;
  BOOL                       bReserved2;
  ULONG                      ulReserved1;
  ULONG                      ulReserved2;
  ULONGLONG                  ullReserved1;
  ULONGLONG                  ullReserved2;
} VDS_POOL_ATTRIBUTES, *PVDS_POOL_ATTRIBUTES;

멤버

ullAttributeMask

이 스토리지 풀에서 정의된 구조체의 특성을 지정하는 마스크입니다.

유효한 특성 플래그 목록은 다음과 같습니다. 각 플래그는 VDS_POOL_ATTRIBUTES 구조체의 멤버에 해당합니다. 사용하지 않는 비트는 예약되어 있습니다.

스토리지 풀에서 정의한 특성
VDS_POOL_ATTRIB_RAIDTYPE
0x1L
raidType
VDS_POOL_ATTRIB_BUSTYPE
0x2L
busType
VDS_POOL_ATTRIB_ALLOW_SPINDOWN
0x4L
bSpinDown
VDS_POOL_ATTRIB_THIN_PROVISION
0x8L
bIsThinProvisioned
VDS_POOL_ATTRIB_NO_SINGLE_POF
0x10L
bNoSinglePointOfFailure
VDS_POOL_ATTRIB_DATA_RDNCY_MAX
0x20L
ulDataRedundancyMax
VDS_POOL_ATTRIB_DATA_RDNCY_MIN
0x40L
ulDataRedundancyMin
VDS_POOL_ATTRIB_DATA_RDNCY_DEF
0x80L
ulDataRedundancyDefault
VDS_POOL_ATTRIB_PKG_RDNCY_MAX
0x100L
ulPackageRedundancyDefault
VDS_POOL_ATTRIB_PKG_RDNCY_MIN
0x200L
ulPackageRedundancyMin
VDS_POOL_ATTRIB_PKG_RDNCY_DEF
0x400L
ulPackageRedundancyDefault
VDS_POOL_ATTRIB_STRIPE_SIZE
0x800L
ulStripeSize
VDS_POOL_ATTRIB_STRIPE_SIZE_MAX
0x1000L
ulStripeSizeMax
VDS_POOL_ATTRIB_STRIPE_SIZE_MIN
0x2000L
ulStripeSizeMin
VDS_POOL_ATTRIB_STRIPE_SIZE_DEF
0x4000L
ulDefaultStripeSize
VDS_POOL_ATTRIB_NUM_CLMNS
0x8000L
ulNumberOfColumns
VDS_POOL_ATTRIB_NUM_CLMNS_MAX
0x10000L
ulNumberOfColumnsMax
VDS_POOL_ATTRIB_NUM_CLMNS_MIN
0x20000L
ulNumberOfColumnsMin
VDS_POOL_ATTRIB_NUM_CLMNS_DEF
0x40000L
ulDefaultNumberofColumns
VDS_POOL_ATTRIB_DATA_AVL_HINT
0x80000L
ulDataAvailabilityHint
VDS_POOL_ATTRIB_ACCS_RNDM_HINT
0x100000L
ulAccessRandomnessHint
VDS_POOL_ATTRIB_ACCS_DIR_HINT
0x200000L
ulAccessDirectionHint
VDS_POOL_ATTRIB_ACCS_SIZE_HINT
0x400000L
ulAccessSizeHint
VDS_POOL_ATTRIB_ACCS_LTNCY_HINT
0x800000L
ulAccessLatencyHint
VDS_POOL_ATTRIB_ACCS_BDW_WT_HINT
0x1000000L
ulAccessBandwidthWeightHint
VDS_POOL_ATTRIB_STOR_COST_HINT
0x2000000L
ulStorageCostHint
VDS_POOL_ATTRIB_STOR_EFFCY_HINT
0x4000000L
ulStorageEfficiencyHint
VDS_POOL_ATTRIB_CUSTOM_ATTRIB
0x8000000L
pPoolCustomAttributes

raidType

스토리지 풀의 RAID 유형을 지정하는 VDS_RAID_TYPE 열거형 값입니다. 스토리지 풀에 특정 RAID 유형이 없는 경우 이 멤버를 VDS_RT_UNKNOWN 설정하고 ullAttributeMask 멤버에서 VDS_POOL_ATTRIB_RAIDTYPE 특성 플래그를 지웁니다.

busType

스토리지 풀에서 드라이브의 버스 유형을 지정하는 VDS_STORAGE_BUS_TYPE 열거형 값입니다.

pwszIntendedUsage

스토리지 풀의 사용을 지정하는 문자열입니다. 일반적으로 스토리지 풀을 사용하는 애플리케이션(예: "SQL" 또는 "Exchange") 또는 스토리지 풀을 사용하는 비즈니스 함수(예: "Finance" 또는 "Human Resources")를 나타낼 수 있습니다.

bSpinDown

TRUE 이면 스토리지 풀의 드라이브가 전원 사용량을 줄이기 위해 자동으로 스핀다운되거나 그렇지 않으면 FALSE 입니다.

bIsThinProvisioned

스토리지 풀이 씬 프로비전된 경우 TRUE이고, 그렇지 않으면 FALSE입니다. 풀이 씬 프로비전된 경우 풀의 사용된 공간에서 바이트 수가 프로비전된 풀 공간의 바이트 수보다 적을 수 있습니다. 프로비전된 공간의 바이트 수는 이 구조체의 ullProvisionedSpace 멤버에 저장됩니다. 사용된 공간의 바이트 수는 VDS_STORAGE_POOL_PROP 구조체의 ullTotalConsumedSpace 멤버에 저장됩니다.) 하드웨어 공급자가 이 멤버를 TRUE로 설정하면 VDS_STORAGE_POOL_PROP 구조체의 형식 멤버도 VDS_SPT_CONCRETE 설정해야 합니다.

ullProvisionedSpace

풀이 씬 프로비전된 경우 이 멤버는 풀에 대해 프로비전되는 공간을 바이트 단위로 지정합니다. 이 멤버의 값은 VDS_STORAGE_POOL_PROP 구조체의 ullTotalConsumedSpace 멤버 값보다 크거나 같아야 합니다.

bNoSinglePointOfFailure

에 단일 실패 지점이 없으면 TRUE이고 그렇지 않으면 FALSE 입니다.

ulDataRedundancyMax

이 스토리지 풀에서 유지할 수 있는 데이터의 전체 복사본의 최대 수입니다.

ulDataRedundancyMin

이 스토리지 풀에서 유지할 수 있는 데이터의 전체 복사본의 최소 수입니다.

ulDataRedundancyDefault

이 스토리지 풀에서 유지 관리되는 데이터의 전체 복사본의 기본 수입니다.

ulPackageRedundancyMax

패키지 중복성을 보장하기 위해 스토리지 풀에서 사용할 수 있는 최대 드라이브 수입니다. 패키지 중복성은 데이터가 손실되지 않고 스토리지 풀에서 실패할 수 있는 드라이브 수를 나타냅니다.

ulPackageRedundancyMin

패키지 중복성을 보장하기 위해 스토리지 풀에서 사용할 수 있는 최소 드라이브 수입니다. 패키지 중복성은 데이터가 손실되지 않고 스토리지 풀에서 실패할 수 있는 드라이브 수를 나타냅니다.

ulPackageRedundancyDefault

패키지 중복성을 보장하기 위해 스토리지 풀에서 사용되는 기본 드라이브 수입니다. 패키지 중복성은 데이터가 손실되지 않고 스토리지 풀에서 실패할 수 있는 드라이브 수를 나타냅니다.

ulStripeSize

풀이 스트라이프된 경우 스토리지 풀의 미러 또는 패리티 스트라이프 크기(바이트)입니다(패리티 사용 여부에 관계없이).

ulStripeSizeMax

스토리지 풀에서 지원하는 최대 스트라이프 크기(바이트)입니다.

ulStripeSizeMin

스토리지 풀에서 지원하는 최소 스트라이프 크기(바이트)입니다.

ulDefaultStripeSize

스토리지 풀에서 지원하는 기본 스트라이프 크기(바이트)입니다.

ulNumberOfColumns

풀이 스트라이프된 경우(패리티 포함 또는 제외) 스토리지 풀의 열 수입니다.

ulNumberOfColumnsMax

스토리지 풀에서 지원하는 최대 열 수입니다.

ulNumberOfColumnsMin

스토리지 풀에서 지원하는 최소 열 수입니다.

ulDefaultNumberofColumns

스토리지 풀에서 지원하는 기본 열 수입니다.

ulDataAvailabilityHint

데이터 가용성에 대한 중요도를 나타내는 클라이언트의 힌트입니다. 값의 범위는 0(중요하지 않음)에서 10(매우 중요)입니다.

ulAccessRandomnessHint

데이터 액세스의 임의성을 나타내는 클라이언트의 힌트입니다. 값의 범위는 0(완전히 순차적)에서 10(완전히 임의)입니다.

ulAccessDirectionHint

데이터 액세스 방향을 나타내는 클라이언트의 힌트입니다. 값 범위는 0(전체 읽기)에서 10(완전히 쓰기)입니다.

ulAccessSizeHint

최적 액세스 크기를 메가바이트 단위로 나타내는 클라이언트의 힌트입니다.

ulAccessLatencyHint

클라이언트에 대한 액세스 대기 시간의 중요도를 나타내는 클라이언트의 힌트입니다. 값의 범위는 0(중요하지 않음)에서 10(매우 중요)입니다.

ulAccessBandwidthWeightHint

높은 대역폭의 중요성을 나타내는 클라이언트의 힌트입니다. 값의 범위는 0(중요하지 않음)에서 10(매우 중요)입니다.

ulStorageCostHint

클라이언트에 대한 스토리지 비용의 중요도를 나타내는 클라이언트의 힌트입니다. 값의 범위는 0(중요하지 않음)에서 10(매우 중요)입니다. 스토리지 비용이 클라이언트에 매우 중요한 경우 값 10은 클라이언트가 낮은 비용의 스토리지를 사용하여 풀을 프로비전하는 것을 선호한다는 것을 나타냅니다.

ulStorageEfficiencyHint

클라이언트에 대한 스토리지 효율성의 중요성을 나타내는 클라이언트의 힌트입니다. 값의 범위는 0(중요하지 않음)에서 10(매우 중요)입니다.

ulNumOfCustomAttributes

스토리지 풀에 대해 정의된 사용자 지정 특성의 수입니다.

pPoolCustomAttributes

VDS_POOL_CUSTOM_ATTRIBUTES 구조체의 배열입니다. 각 구조체에는 스토리지 풀에 대해 정의된 사용자 지정 특성이 포함되어 있습니다.

bReserved1

이 멤버는 나중에 사용하도록 예약되어 있습니다. 사용하지 마십시오.

bReserved2

이 멤버는 나중에 사용하도록 예약되어 있습니다. 사용하지 마십시오.

ulReserved1

이 멤버는 나중에 사용하도록 예약되어 있습니다. 사용하지 마십시오.

ulReserved2

이 멤버는 나중에 사용하도록 예약되어 있습니다. 사용하지 마십시오.

ullReserved1

이 멤버는 나중에 사용하도록 예약되어 있습니다. 사용하지 마십시오.

ullReserved2

이 멤버는 나중에 사용하도록 예약되어 있습니다. 사용하지 마십시오.

설명

스토리지 풀에 대해 특성이 설정된 경우 해당 특성 설정은 풀을 구성하는 모든 드라이브 익스텐트에 적용되어야 합니다.

요구 사항

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

추가 정보

IVdsHwProviderStoragePools::QueryStoragePools

IVdsStoragePool::GetAttributes