VDS_STORAGE_POOL_PROP
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| id | GUID | 16 | +0 | +0 | ストレージ プール オブジェクトを識別する VDS_OBJECT_ID 値です。 |
| status | VDS_STORAGE_POOL_STATUS | 4 | +16 | +16 | ストレージ プールの状態を指定する VDS_STORAGE_POOL_STATUS 列挙型の値です。 |
| health | VDS_HEALTH | 4 | +20 | +20 | ストレージ プールの正常性を指定する VDS_HEALTH 列挙型の値です。このメンバーの有効な値は次のとおりです。 Windows Server 2008、Windows Vista および Windows Server 2003: VDS_H_DEGRADED はサポートされていません。 VDS_H_UNKNOWN (0)VDS_H_HEALTHY (1)VDS_H_DEGRADED (11) |
| type | VDS_STORAGE_POOL_TYPE | 4 | +24 | +24 | ストレージ プールの種類を指定する VDS_STORAGE_POOL_TYPE 列挙型の値です。 |
| pwszName | LPWSTR | 8/4 | +32 | +28 | ストレージ プールの名前を指定する文字列です。 |
| pwszDescription | LPWSTR | 8/4 | +40 | +32 | ストレージ プールの説明を含む文字列です。 |
| ullTotalConsumedSpace | ULONGLONG | 8 | +48 | +40 | ストレージ プールを裏付ける物理ストレージの容量 (バイト単位)。このメンバーの値は、VDS_POOL_ATTRIBUTES 構造体の ullProvisionedSpace メンバーの値以下でなければなりません。 |
| ullTotalManagedSpace | ULONGLONG | 8 | +56 | +48 | このストレージ プール内で、子ストレージ要素 (LUN またはプール) を作成するために割り当て可能な領域 (バイト単位) です。既に割り当て済みの領域も含まれます。ストレージ プールの構成方法によっては、このメンバーの値が ullTotalConsumedSpace メンバーの値よりもはるかに小さくなることがあります。たとえば、ストレージ プールがミラー プールとして構成されている場合、ullTotalManagedSpace の値は ullTotalConsumedSpace メンバーの値の半分にしかなりません。 |
| ullRemainingFreeSpace | ULONGLONG | 8 | +64 | +56 | このプールから新しい LUN または子ストレージ プールを作成する場合、あるいは既存の LUN または子ストレージ プールを拡張する場合に使用できる最大サイズです。既存の LUN または子ストレージ プールに既に割り当てられている管理対象領域の量を求めるには、ullTotalManagedSpace メンバーの値からこのメンバーの値を減算します。 - health.VDS_H_DEGRADED (11)- health.VDS_H_HEALTHY (1)- health.VDS_H_UNKNOWN (0) |
公式ドキュメント
[Windows 8 および Windows Server 2012 以降、Virtual Disk Service COM インターフェイスは Windows Storage Management API に置き換えられています。]
ストレージ プール オブジェクトのプロパティを定義します。
解説(Remarks)
IVdsStoragePool::GetProperties は、ストレージ プール オブジェクトのプロパティを報告するために、この構造体を返します。
次の例は、ullTotalConsumedSpace、ullTotalManagedSpace、ullRemainingFreeSpace の各メンバーがどのように連携するかを示しています。
例 1
1 TB のドライブが 2 台あるとします。さらに、次の操作を行うとします。- ストレージ プールをミラー プールとして作成します。
- サイズが 200 GB の LUN を作成します。
ullTotalConsumedSpace = 2 TB。これは、物理ストレージまたは物理ディスクによって裏付けられているストレージ プール領域の容量です。プールから LUN を作成しても、この数値は変わりません。
ullTotalManagedSpace = 1 TB。これは、このプールから作成できる LUN またはストレージ プールの最大サイズです。プールの種類がプレックス 2 つだけのミラーであるため、使用できるのは 1 TB のみです。
ullRemainingFreeSpace = 800 GB (1 TB – 200 GB)。200 GB が既に LUN に割り当てられているためです。
(ullTotalManagedSpace - ullRemainingFreeSpace) は、このプールから作成された LUN およびプールに割り当てられた管理対象領域の量です。この例では、ullTotalManagedSpace - ullRemainingFreeSpace = 200 GB です。
例 2
1 TB のドライブが 2 台あるとします。さらに、次の操作を行うとします。- ストレージ プールをミラー プールとして作成します。
- サイズが 10 TB のシン プロビジョニング LUN を作成します。
ullProvisionedSpace = 10 TB。これはシン プロビジョニングされたプールにのみ適用されます。これは、プールにプロビジョニングされた合計領域です。プールによって消費される合計領域は、プールにプロビジョニングされた合計領域以下になります。
ullTotalConsumedSpace = 2 TB。
ullTotalManagedSpace = 1 TB。
ullRemainingFreeSpace = 1 TB から、現在 LUN を裏付けている管理対象領域の量を引いた値です。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// VDS_STORAGE_POOL_PROP (x64 72 / x86 64 バイト)
typedef struct VDS_STORAGE_POOL_PROP {
GUID id;
VDS_STORAGE_POOL_STATUS status;
VDS_HEALTH health;
VDS_STORAGE_POOL_TYPE type;
LPWSTR pwszName;
LPWSTR pwszDescription;
ULONGLONG ullTotalConsumedSpace;
ULONGLONG ullTotalManagedSpace;
ULONGLONG ullRemainingFreeSpace;
} VDS_STORAGE_POOL_PROP;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct VDS_STORAGE_POOL_PROP
{
public Guid id;
public int status;
public int health;
public int type;
public IntPtr pwszName;
public IntPtr pwszDescription;
public ulong ullTotalConsumedSpace;
public ulong ullTotalManagedSpace;
public ulong ullRemainingFreeSpace;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure VDS_STORAGE_POOL_PROP
Public id As Guid
Public status As Integer
Public health As Integer
Public type As Integer
Public pwszName As IntPtr
Public pwszDescription As IntPtr
Public ullTotalConsumedSpace As ULong
Public ullTotalManagedSpace As ULong
Public ullRemainingFreeSpace As ULong
End Structureimport ctypes
from ctypes import wintypes
class VDS_STORAGE_POOL_PROP(ctypes.Structure):
_fields_ = [
("id", GUID),
("status", ctypes.c_int),
("health", ctypes.c_int),
("type", ctypes.c_int),
("pwszName", ctypes.c_void_p),
("pwszDescription", ctypes.c_void_p),
("ullTotalConsumedSpace", ctypes.c_ulonglong),
("ullTotalManagedSpace", ctypes.c_ulonglong),
("ullRemainingFreeSpace", ctypes.c_ulonglong),
]#[repr(C)]
pub struct VDS_STORAGE_POOL_PROP {
pub id: GUID,
pub status: i32,
pub health: i32,
pub type: i32,
pub pwszName: *mut core::ffi::c_void,
pub pwszDescription: *mut core::ffi::c_void,
pub ullTotalConsumedSpace: u64,
pub ullTotalManagedSpace: u64,
pub ullRemainingFreeSpace: u64,
}import "golang.org/x/sys/windows"
type VDS_STORAGE_POOL_PROP struct {
id windows.GUID
status int32
health int32
type int32
pwszName uintptr
pwszDescription uintptr
ullTotalConsumedSpace uint64
ullTotalManagedSpace uint64
ullRemainingFreeSpace uint64
}type
VDS_STORAGE_POOL_PROP = record
id: TGUID;
status: Integer;
health: Integer;
type: Integer;
pwszName: Pointer;
pwszDescription: Pointer;
ullTotalConsumedSpace: UInt64;
ullTotalManagedSpace: UInt64;
ullRemainingFreeSpace: UInt64;
end;const VDS_STORAGE_POOL_PROP = extern struct {
id: GUID,
status: i32,
health: i32,
type: i32,
pwszName: ?*anyopaque,
pwszDescription: ?*anyopaque,
ullTotalConsumedSpace: u64,
ullTotalManagedSpace: u64,
ullRemainingFreeSpace: u64,
};type
VDS_STORAGE_POOL_PROP {.bycopy.} = object
id: GUID
status: int32
health: int32
type: int32
pwszName: pointer
pwszDescription: pointer
ullTotalConsumedSpace: uint64
ullTotalManagedSpace: uint64
ullRemainingFreeSpace: uint64struct VDS_STORAGE_POOL_PROP
{
GUID id;
int status;
int health;
int type;
void* pwszName;
void* pwszDescription;
ulong ullTotalConsumedSpace;
ulong ullTotalManagedSpace;
ulong ullRemainingFreeSpace;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; VDS_STORAGE_POOL_PROP サイズ: 64 バイト(x86)
dim st, 16 ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; id : GUID (+0, 16byte) varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; status : VDS_STORAGE_POOL_STATUS (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; health : VDS_HEALTH (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; type : VDS_STORAGE_POOL_TYPE (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; pwszName : LPWSTR (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; pwszDescription : LPWSTR (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; ullTotalConsumedSpace : ULONGLONG (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ullTotalManagedSpace : ULONGLONG (+48, 8byte) qpoke st,48,値 / qpeek(st,48) ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; ullRemainingFreeSpace : ULONGLONG (+56, 8byte) qpoke st,56,値 / qpeek(st,56) ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; VDS_STORAGE_POOL_PROP サイズ: 72 バイト(x64)
dim st, 18 ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; id : GUID (+0, 16byte) varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; status : VDS_STORAGE_POOL_STATUS (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; health : VDS_HEALTH (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; type : VDS_STORAGE_POOL_TYPE (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; pwszName : LPWSTR (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; pwszDescription : LPWSTR (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ullTotalConsumedSpace : ULONGLONG (+48, 8byte) qpoke st,48,値 / qpeek(st,48) ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; ullTotalManagedSpace : ULONGLONG (+56, 8byte) qpoke st,56,値 / qpeek(st,56) ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; ullRemainingFreeSpace : ULONGLONG (+64, 8byte) qpoke st,64,値 / qpeek(st,64) ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
#field int Data1
#field short Data2
#field short Data3
#field byte Data4 8
#endstruct
#defstruct global VDS_STORAGE_POOL_PROP
#field GUID id
#field int status
#field int health
#field int type
#field intptr pwszName
#field intptr pwszDescription
#field int64 ullTotalConsumedSpace
#field int64 ullTotalManagedSpace
#field int64 ullRemainingFreeSpace
#endstruct
stdim st, VDS_STORAGE_POOL_PROP ; NSTRUCT 変数を確保
st->status = 100
mes "status=" + st->status