VDS_POOL_ATTRIBUTES-Struktur (vdshwprv.h)

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]

Definiert die Attribute eines Speicherpools.

Syntax

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;

Member

ullAttributeMask

Eine Maske, die die Attribute in der Struktur angibt, die von diesem Speicherpool definiert werden.

Die Liste der gültigen Attributflags lautet wie folgt. Jedes Flag entspricht einem Element in der VDS_POOL_ATTRIBUTES-Struktur . Nicht verwendete Bits sind reserviert.

Wert Vom Speicherpool definiertes Attribut
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

Ein VDS_RAID_TYPE Enumerationswert, der den RAID-Typ des Speicherpools angibt. Wenn der Speicherpool keinen bestimmten RAID-Typ aufweist, legen Sie diesen Member auf VDS_RT_UNKNOWN fest, und löschen Sie das Attributflag VDS_POOL_ATTRIB_RAIDTYPE im ullAttributeMask-Member .

busType

Ein VDS_STORAGE_BUS_TYPE Enumerationswert, der den Bustyp der Laufwerke im Speicherpool angibt.

pwszIntendedUsage

Eine Zeichenfolge, die die Verwendung des Speicherpools angibt. In der Regel kann dies die Anwendung angeben, die den Speicherpool (z. B. "SQL" oder "Exchange") verwendet, oder die Geschäftsfunktion, die den Speicherpool verwendet (z. B. "Finanzen" oder "Personalwesen").

bSpinDown

TRUE , wenn die Laufwerke im Speicherpool automatisch heruntergefahren werden, um den Energieverbrauch zu reduzieren, oder andernfalls FALSE .

bIsThinProvisioned

TRUE , wenn der Speicherpool dünn bereitgestellt ist, oder andernfalls FALSE . Wenn der Pool dünn bereitgestellt ist, kann die Anzahl der Bytes im verbrauchten Speicherplatz des Pools kleiner sein als die Anzahl der Bytes im bereitgestellten Speicherplatz des Pools. (Die Anzahl der Bytes im bereitgestellten Speicherplatz wird im ullProvisionedSpace-Element dieser Struktur gespeichert. Die Anzahl der Bytes im verbrauchten Speicherplatz wird im ullTotalConsumedSpace-Element der VDS_STORAGE_POOL_PROP-Struktur gespeichert.) Wenn ein Hardwareanbieter diesen Member auf TRUE festlegt, muss er auch den Typmember der VDS_STORAGE_POOL_PROP-Struktur auf VDS_SPT_CONCRETE festlegen.

ullProvisionedSpace

Wenn der Pool dünn bereitgestellt ist, gibt dieser Member den Speicherplatz in Bytes an, der für den Pool bereitgestellt wird. Der Wert dieses Members muss größer oder gleich dem Wert des ullTotalConsumedSpace-Elements der VDS_STORAGE_POOL_PROP-Struktur sein.

bNoSinglePointOfFailure

TRUE , wenn im Pool kein Single Point of Failure vorhanden ist, andernfalls FALSE .

ulDataRedundancyMax

Die maximale Anzahl vollständiger Kopien der Daten, die in diesem Speicherpool verwaltet werden können.

ulDataRedundancyMin

Die Mindestanzahl vollständiger Kopien der Daten, die in diesem Speicherpool verwaltet werden können.

ulDataRedundancyDefault

Die Standardanzahl vollständiger Kopien der Daten, die in diesem Speicherpool verwaltet werden.

ulPackageRedundancyMax

Die maximale Anzahl von Laufwerken, die im Speicherpool verwendet werden können, um Paketredundanz sicherzustellen. Die Paketredundanz gibt die Anzahl der Laufwerke an, die im Speicherpool fehlschlagen können, ohne dass es zu einem Datenverlust führt.

ulPackageRedundancyMin

Die Mindestanzahl von Laufwerken, die im Speicherpool verwendet werden können, um Paketredundanz sicherzustellen. Die Paketredundanz gibt die Anzahl der Laufwerke an, die im Speicherpool fehlschlagen können, ohne dass es zu einem Datenverlust führt.

ulPackageRedundancyDefault

Die Standardanzahl von Laufwerken, die im Speicherpool verwendet werden, um Paketredundanz sicherzustellen. Die Paketredundanz gibt die Anzahl der Laufwerke an, die im Speicherpool fehlschlagen können, ohne dass es zu einem Datenverlust führt.

ulStripeSize

Die Spiegel- oder Paritätsstreifengröße des Speicherpools in Byte, wenn der Pool mit oder ohne Parität gestreift ist.

ulStripeSizeMax

Die maximale Stripegröße in Bytes, die vom Speicherpool unterstützt wird.

ulStripeSizeMin

Die minimale Stripegröße in Bytes, die vom Speicherpool unterstützt wird.

ulDefaultStripeSize

Die standardmäßige Stripegröße in Bytes, die vom Speicherpool unterstützt wird.

ulNumberOfColumns

Die Anzahl der Spalten des Speicherpools, wenn der Pool mit einem Stripet versehen ist (mit oder ohne Parität).

ulNumberOfColumnsMax

Die maximale Anzahl von Spalten, die vom Speicherpool unterstützt werden.

ulNumberOfColumnsMin

Die Mindestanzahl von Spalten, die vom Speicherpool unterstützt werden.

ulDefaultNumberofColumns

Die Standardanzahl von Spalten, die vom Speicherpool unterstützt werden.

ulDataAvailabilityHint

Ein Hinweis vom Client, der angibt, wie wichtig die Datenverfügbarkeit ist. Die Werte reichen von 0 (nicht wichtig) bis 10 (sehr wichtig).

ulAccessRandomnessHint

Ein Hinweis vom Client, der die Zufälligkeit des Datenzugriffs angibt. Die Werte reichen von 0 (vollständig sequenziell) bis 10 (vollständig zufällig).

ulAccessDirectionHint

Ein Hinweis vom Client, der die Richtung des Datenzugriffs angibt. Die Werte reichen von 0 (vollständig gelesen) bis 10 (vollständig geschrieben).

ulAccessSizeHint

Ein Hinweis vom Client, der die optimale Zugriffsgröße in Megabyte angibt.

ulAccessLatencyHint

Ein Hinweis vom Client, der angibt, wie wichtig die Zugriffslatenz für den Client ist. Die Werte reichen von 0 (nicht wichtig) bis 10 (sehr wichtig).

ulAccessBandwidthWeightHint

Ein Hinweis vom Client, der die Wichtigkeit einer hohen Bandbreite angibt. Die Werte reichen von 0 (nicht wichtig) bis 10 (sehr wichtig).

ulStorageCostHint

Ein Hinweis vom Client, der angibt, wie wichtig die Speicherkosten für den Client sind. Die Werte reichen von 0 (nicht wichtig) bis 10 (sehr wichtig). Wenn die Speicherkosten für den Client sehr wichtig sind, gibt der Wert 10 an, dass der Client es vorziehen würde, den Pool mit kostengünstigerem Speicher bereitzustellen.

ulStorageEfficiencyHint

Ein Hinweis vom Client, der angibt, wie wichtig die Speichereffizienz für den Client ist. Die Werte reichen von 0 (nicht wichtig) bis 10 (sehr wichtig).

ulNumOfCustomAttributes

Die Anzahl der benutzerdefinierten Attribute, die für den Speicherpool definiert sind.

pPoolCustomAttributes

Ein Array von VDS_POOL_CUSTOM_ATTRIBUTES Strukturen. Jede Struktur enthält ein benutzerdefiniertes Attribut, das für den Speicherpool definiert ist.

bReserved1

Dieses Element ist für die zukünftige Verwendung reserviert. Nicht verwenden.

bReserved2

Dieses Element ist für die zukünftige Verwendung reserviert. Nicht verwenden.

ulReserved1

Dieses Element ist für die zukünftige Verwendung reserviert. Nicht verwenden.

ulReserved2

Dieses Element ist für die zukünftige Verwendung reserviert. Nicht verwenden.

ullReserved1

Dieses Element ist für die zukünftige Verwendung reserviert. Nicht verwenden.

ullReserved2

Dieses Element ist für die zukünftige Verwendung reserviert. Nicht verwenden.

Hinweise

Wenn ein Attribut für einen Speicherpool festgelegt ist, muss diese Attributeinstellung für alle Laufwerksblöcke gelten, aus denen der Pool besteht.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile vdshwprv.h

Weitere Informationen

IVdsHwProviderStoragePools::QueryStoragePools

IVdsStoragePool::GetAttributes