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

VDS_VOLUME_PROP2

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

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

フィールド

フィールドサイズx64x86説明
idGUID16+0+0ボリュームの GUID です。
typeVDS_VOLUME_TYPE4+16+16ボリュームの種類を指定する VDS_VOLUME_TYPE 列挙型の値です。ボリュームの種類は、シンプル、スパン、ストライプ (RAID-0)、ミラー、またはパリティ付きストライプ (RAID-5) です。
statusVDS_VOLUME_STATUS4+20+20ボリュームの状態を指定する VDS_VOLUME_STATUS 列挙型の値です。
healthVDS_HEALTH4+24+24ボリュームの正常性状態を指定する VDS_HEALTH 列挙型の値です。
TransitionStateVDS_TRANSITION_STATE4+28+28ボリュームの遷移状態を指定する VDS_TRANSITION_STATE 列挙型の値です。
ullSizeULONGLONG8+32+32ボリュームのサイズ (バイト単位) です。
ulFlagsDWORD4+40+40ボリュームを説明する VDS_VOLUME_FLAG 列挙型の値のビットマスクです。
RecommendedFileSystemTypeVDS_FILE_SYSTEM_TYPE4+44+44ボリュームに推奨されるファイル システムを指定する VDS_FILE_SYSTEM_TYPE 列挙型の値です。次のいずれかでなければなりません: VDS_FST_NTFSVDS_FST_FATVDS_FST_FAT32VDS_FST_UDFVDS_FST_CDFSVDS_FST_UNKNOWN
cbUniqueIdDWORD4+48+48pUniqueId メンバーが指すバイト配列の長さです。
pwszNameLPWSTR8/4+56+52CreateFile 関数でボリュームのハンドルを開くときに使用された名前です。たとえば、\?\GLOBALROOT\Device\HarddiskVolume1 のような名前です。
pUniqueIdBYTE*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 の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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 Structure
import 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: pointer
struct 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