Win32 API 日本語リファレンス
ホームStorage.VirtualDiskService › VDS_STORAGE_POOL_PROP

VDS_STORAGE_POOL_PROP

構造体
サイズx64: 72 バイト / x86: 64 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
idGUID16+0+0ストレージ プール オブジェクトを識別する VDS_OBJECT_ID 値です。
statusVDS_STORAGE_POOL_STATUS4+16+16ストレージ プールの状態を指定する VDS_STORAGE_POOL_STATUS 列挙型の値です。
healthVDS_HEALTH4+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)

typeVDS_STORAGE_POOL_TYPE4+24+24ストレージ プールの種類を指定する VDS_STORAGE_POOL_TYPE 列挙型の値です。
pwszNameLPWSTR8/4+32+28ストレージ プールの名前を指定する文字列です。
pwszDescriptionLPWSTR8/4+40+32ストレージ プールの説明を含む文字列です。
ullTotalConsumedSpaceULONGLONG8+48+40ストレージ プールを裏付ける物理ストレージの容量 (バイト単位)。このメンバーの値は、VDS_POOL_ATTRIBUTES 構造体の ullProvisionedSpace メンバーの値以下でなければなりません。
ullTotalManagedSpaceULONGLONG8+56+48このストレージ プール内で、子ストレージ要素 (LUN またはプール) を作成するために割り当て可能な領域 (バイト単位) です。既に割り当て済みの領域も含まれます。ストレージ プールの構成方法によっては、このメンバーの値が ullTotalConsumedSpace メンバーの値よりもはるかに小さくなることがあります。たとえば、ストレージ プールがミラー プールとして構成されている場合、ullTotalManagedSpace の値は ullTotalConsumedSpace メンバーの値の半分にしかなりません。
ullRemainingFreeSpaceULONGLONG8+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 は、ストレージ プール オブジェクトのプロパティを報告するために、この構造体を返します。

次の例は、ullTotalConsumedSpaceullTotalManagedSpaceullRemainingFreeSpace の各メンバーがどのように連携するかを示しています。

例 1

1 TB のドライブが 2 台あるとします。さらに、次の操作を行うとします。
  1. ストレージ プールをミラー プールとして作成します。
  2. サイズが 200 GB の LUN を作成します。

ullTotalConsumedSpace = 2 TB。これは、物理ストレージまたは物理ディスクによって裏付けられているストレージ プール領域の容量です。プールから LUN を作成しても、この数値は変わりません。

ullTotalManagedSpace = 1 TB。これは、このプールから作成できる LUN またはストレージ プールの最大サイズです。プールの種類がプレックス 2 つだけのミラーであるため、使用できるのは 1 TB のみです。

メモ プールの種類が RAID5 の場合、ullTotalManagedSpace は (N-1)/N * ullTotalConsumedSpace になります (N は列数)。たとえば、5 台のドライブで 5 列の場合、ullTotalManagedSpace は (5-1)/5 * ullTotalConsumedSpace、つまり 1.6 TB になります。

ullRemainingFreeSpace = 800 GB (1 TB – 200 GB)。200 GB が既に LUN に割り当てられているためです。

(ullTotalManagedSpace - ullRemainingFreeSpace) は、このプールから作成された LUN およびプールに割り当てられた管理対象領域の量です。この例では、ullTotalManagedSpace - ullRemainingFreeSpace = 200 GB です。

例 2

1 TB のドライブが 2 台あるとします。さらに、次の操作を行うとします。
  1. ストレージ プールをミラー プールとして作成します。
  2. サイズが 10 TB のシン プロビジョニング LUN を作成します。

ullProvisionedSpace = 10 TB。これはシン プロビジョニングされたプールにのみ適用されます。これは、プールにプロビジョニングされた合計領域です。プールによって消費される合計領域は、プールにプロビジョニングされた合計領域以下になります。

ullTotalConsumedSpace = 2 TB。

ullTotalManagedSpace = 1 TB。

ullRemainingFreeSpace = 1 TB から、現在 LUN を裏付けている管理対象領域の量を引いた値です。

メモ LUN のサイズは 10 TB ですが、LUN を裏付けている管理対象領域は 10 GB しかない場合もあります。その場合、ミラー化された LUN を裏付ける消費領域は 20 GB になります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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 Structure
import 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: uint64
struct 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