VDS_VOLUME_PROP2
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| id | GUID | 16 | +0 | +0 | ボリュームの GUID です。 |
| type | VDS_VOLUME_TYPE | 4 | +16 | +16 | ボリュームの種類を指定する VDS_VOLUME_TYPE 列挙型の値です。ボリュームの種類は、シンプル、スパン、ストライプ (RAID-0)、ミラー、またはパリティ付きストライプ (RAID-5) です。 |
| status | VDS_VOLUME_STATUS | 4 | +20 | +20 | ボリュームの状態を指定する VDS_VOLUME_STATUS 列挙型の値です。 |
| health | VDS_HEALTH | 4 | +24 | +24 | ボリュームの正常性状態を指定する VDS_HEALTH 列挙型の値です。 |
| TransitionState | VDS_TRANSITION_STATE | 4 | +28 | +28 | ボリュームの遷移状態を指定する VDS_TRANSITION_STATE 列挙型の値です。 |
| ullSize | ULONGLONG | 8 | +32 | +32 | ボリュームのサイズ (バイト単位) です。 |
| ulFlags | DWORD | 4 | +40 | +40 | ボリュームを説明する VDS_VOLUME_FLAG 列挙型の値のビットマスクです。 |
| RecommendedFileSystemType | VDS_FILE_SYSTEM_TYPE | 4 | +44 | +44 | ボリュームに推奨されるファイル システムを指定する VDS_FILE_SYSTEM_TYPE 列挙型の値です。次のいずれかでなければなりません: VDS_FST_NTFS、VDS_FST_FAT、VDS_FST_FAT32、VDS_FST_UDF、VDS_FST_CDFS、VDS_FST_UNKNOWN。 |
| cbUniqueId | DWORD | 4 | +48 | +48 | pUniqueId メンバーが指すバイト配列の長さです。 |
| pwszName | LPWSTR | 8/4 | +56 | +52 | CreateFile 関数でボリュームのハンドルを開くときに使用された名前です。たとえば、\?\GLOBALROOT\Device\HarddiskVolume1 のような名前です。 |
| pUniqueId | BYTE* | 8/4 | +64 | +56 | ボリュームの一意識別子を格納するバイト配列です。 |
公式ドキュメント
[Windows 8 および Windows Server 2012 以降、Virtual Disk Service COM インターフェイスは Windows Storage Management API に置き換えられています。]
ボリューム オブジェクトのプロパティを定義します。この構造体は VDS_VOLUME_PROP 構造体と同一ですが、ボリュームの GUID も含んでいる点が異なります。
解説(Remarks)
IVdsVolume2::GetProperties2 メソッドは、ボリューム オブジェクトのプロパティを報告するためにこの構造体を返します。
ボリュームがオフラインの場合、VDS_VOLUME_PROP2 構造体の ulFlags メンバーに VDS_VF_PERMANENTLY_DISMOUNTED フラグが設定され、さらにこの構造体の status メンバーにもボリューム状態の値 VDS_VS_OFFLINE が設定されます。
GPT ボリュームおよびダイナミック ボリュームの場合、pUniqueId メンバーが指す一意識別子はグローバルに一意です。
リムーバブル メディア ドライブの場合、デバイスにメディアが挿入されていなくてもボリュームは存在し、独自の一意識別子を持ちます。リムーバブル メディア上でボリュームがフォーマットされている場合、そのボリュームは独自の一意識別子を持ちます。詳細については、Supporting Mount Manager Requests in a Storage Class Driver を参照してください。
一意識別子の形式は、デバイスやボリュームの種類によって異なる場合があります。MBR ディスク上のベーシック ボリュームの場合、一意識別子はディスク シグネチャとパーティション オフセットに基づいて決まります。ディスク シグネチャとパーティション オフセットは DWORD 値であるため、一意識別子がコンピューター間でグローバルに一意であることは保証されません。
ディスク シグネチャが変更されると、ボリュームの一意識別子も変更されます。ディスク シグネチャの変更は、通常、ディスクのクローン作成時の競合の結果として発生します。
一意識別子はボリューム GUID パスと同じものではないことに注意してください。ボリュームのボリューム GUID パスを調べるには、IVdsVolumeMF3::QueryVolumeGuidPathnames メソッドを使用してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// VDS_VOLUME_PROP2 (x64 72 / x86 64 バイト)
typedef struct VDS_VOLUME_PROP2 {
GUID id;
VDS_VOLUME_TYPE type;
VDS_VOLUME_STATUS status;
VDS_HEALTH health;
VDS_TRANSITION_STATE TransitionState;
ULONGLONG ullSize;
DWORD ulFlags;
VDS_FILE_SYSTEM_TYPE RecommendedFileSystemType;
DWORD cbUniqueId;
LPWSTR pwszName;
BYTE* pUniqueId;
} VDS_VOLUME_PROP2;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct VDS_VOLUME_PROP2
{
public Guid id;
public int type;
public int status;
public int health;
public int TransitionState;
public ulong ullSize;
public uint ulFlags;
public int RecommendedFileSystemType;
public uint cbUniqueId;
public IntPtr pwszName;
public IntPtr pUniqueId;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure VDS_VOLUME_PROP2
Public id As Guid
Public type As Integer
Public status As Integer
Public health As Integer
Public TransitionState As Integer
Public ullSize As ULong
Public ulFlags As UInteger
Public RecommendedFileSystemType As Integer
Public cbUniqueId As UInteger
Public pwszName As IntPtr
Public pUniqueId As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class VDS_VOLUME_PROP2(ctypes.Structure):
_fields_ = [
("id", GUID),
("type", ctypes.c_int),
("status", ctypes.c_int),
("health", ctypes.c_int),
("TransitionState", ctypes.c_int),
("ullSize", ctypes.c_ulonglong),
("ulFlags", wintypes.DWORD),
("RecommendedFileSystemType", ctypes.c_int),
("cbUniqueId", wintypes.DWORD),
("pwszName", ctypes.c_void_p),
("pUniqueId", ctypes.c_void_p),
]#[repr(C)]
pub struct VDS_VOLUME_PROP2 {
pub id: GUID,
pub type: i32,
pub status: i32,
pub health: i32,
pub TransitionState: i32,
pub ullSize: u64,
pub ulFlags: u32,
pub RecommendedFileSystemType: i32,
pub cbUniqueId: u32,
pub pwszName: *mut core::ffi::c_void,
pub pUniqueId: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type VDS_VOLUME_PROP2 struct {
id windows.GUID
type int32
status int32
health int32
TransitionState int32
ullSize uint64
ulFlags uint32
RecommendedFileSystemType int32
cbUniqueId uint32
pwszName uintptr
pUniqueId uintptr
}type
VDS_VOLUME_PROP2 = record
id: TGUID;
type: Integer;
status: Integer;
health: Integer;
TransitionState: Integer;
ullSize: UInt64;
ulFlags: DWORD;
RecommendedFileSystemType: Integer;
cbUniqueId: DWORD;
pwszName: Pointer;
pUniqueId: Pointer;
end;const VDS_VOLUME_PROP2 = extern struct {
id: GUID,
type: i32,
status: i32,
health: i32,
TransitionState: i32,
ullSize: u64,
ulFlags: u32,
RecommendedFileSystemType: i32,
cbUniqueId: u32,
pwszName: ?*anyopaque,
pUniqueId: ?*anyopaque,
};type
VDS_VOLUME_PROP2 {.bycopy.} = object
id: GUID
type: int32
status: int32
health: int32
TransitionState: int32
ullSize: uint64
ulFlags: uint32
RecommendedFileSystemType: int32
cbUniqueId: uint32
pwszName: pointer
pUniqueId: pointerstruct VDS_VOLUME_PROP2
{
GUID id;
int type;
int status;
int health;
int TransitionState;
ulong ullSize;
uint ulFlags;
int RecommendedFileSystemType;
uint cbUniqueId;
void* pwszName;
void* pUniqueId;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; VDS_VOLUME_PROP2 サイズ: 64 バイト(x86)
dim st, 16 ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; id : GUID (+0, 16byte) varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; type : VDS_VOLUME_TYPE (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; status : VDS_VOLUME_STATUS (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; health : VDS_HEALTH (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; TransitionState : VDS_TRANSITION_STATE (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; ullSize : ULONGLONG (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; ulFlags : DWORD (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; RecommendedFileSystemType : VDS_FILE_SYSTEM_TYPE (+44, 4byte) st.11 = 値 / 値 = st.11 (lpoke/lpeek も可)
; cbUniqueId : DWORD (+48, 4byte) st.12 = 値 / 値 = st.12 (lpoke/lpeek も可)
; pwszName : LPWSTR (+52, 4byte) st.13 = 値 / 値 = st.13 (lpoke/lpeek も可)
; pUniqueId : BYTE* (+56, 4byte) st.14 = 値 / 値 = st.14 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; VDS_VOLUME_PROP2 サイズ: 72 バイト(x64)
dim st, 18 ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; id : GUID (+0, 16byte) varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; type : VDS_VOLUME_TYPE (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; status : VDS_VOLUME_STATUS (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; health : VDS_HEALTH (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; TransitionState : VDS_TRANSITION_STATE (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; ullSize : ULONGLONG (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; ulFlags : DWORD (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; RecommendedFileSystemType : VDS_FILE_SYSTEM_TYPE (+44, 4byte) st.11 = 値 / 値 = st.11 (lpoke/lpeek も可)
; cbUniqueId : DWORD (+48, 4byte) st.12 = 値 / 値 = st.12 (lpoke/lpeek も可)
; pwszName : LPWSTR (+56, 8byte) qpoke st,56,値 / qpeek(st,56) ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; pUniqueId : BYTE* (+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_VOLUME_PROP2
#field GUID id
#field int type
#field int status
#field int health
#field int TransitionState
#field int64 ullSize
#field int ulFlags
#field int RecommendedFileSystemType
#field int cbUniqueId
#field intptr pwszName
#field intptr pUniqueId
#endstruct
stdim st, VDS_VOLUME_PROP2 ; NSTRUCT 変数を確保
st->type = 100
mes "type=" + st->type