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 구조체의 멤버에 해당합니다. 사용하지 않는 비트는 예약되어 있습니다.
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 |