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

VDS_INPUT_DISK

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

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

フィールド

フィールドサイズx64x86説明
diskIdGUID16+0+0ディスクの GUID。このフィールドは必須です。
ullSizeULONGLONG8+16+16ディスクのサイズ (バイト単位)。このフィールドは必須です。入力ディスクに割り当てられるディスクエクステントのオフセット、長さ、および数は、プロバイダーのポリシーによって決まります。
plexIdGUID16+24+24

ボリュームを拡張する場合は、ディスクが属するプレックスの GUID。ボリュームの作成時および RAID-5 ボリュームの修復時には、VDS はこのメンバーを無視します。

注意 呼び出し元は、同一の操作ですべてのプレックスのすべてのメンバーを拡張することによってのみ、ボリュームを拡張できます。
memberIdxDWORD4+40+40

エクステントが属するディスクのメンバーインデックス。すべてのディスクに対して memberIdx を指定するか、まったく指定しないかのいずれかにしてください。VDS は、同じ memberIdx を持つディスクを、配列に現れる順序で使用します。たとえば、配列内の最初のディスクが常に最初に使用されます。

注意 RAID-5 ボリュームを修復する場合は、memberIdx を指定しないでください。

公式ドキュメント

[Windows 8 および Windows Server 2012 以降、Virtual Disk Service COM インターフェイスは Windows Storage Management API に置き換えられています。]

入力ディスクの詳細を定義します。

解説(Remarks)

1 つのディスクが同じボリュームに対して複数のプレックスを提供することはできません。ただし、1 つのディスクが複数のボリュームに提供することは可能です。

呼び出し元は、すべてのディスクにメンバーインデックスを指定することも、すべてのディスクで既定のメンバーインデックスを使用することもできます。同じ配列に含まれるディスクに対して、指定したメンバーインデックスと既定のメンバーインデックスを混在させないでください。ボリュームがメンバーを 1 つだけ持つプレックス 1 つのみで構成されている場合を除き、既定のメンバーインデックスを IVdsVolume::Extend メソッドと組み合わせて使用することは避けてください。

IVdsPack::CreateVolumeIVdsVolume::Extend、および IVdsVolumePlex::Repair の各メソッドは、ディスクの入力情報を指定するための引数としてこの構造体を渡します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// VDS_INPUT_DISK  (x64 48 / x86 48 バイト)
typedef struct VDS_INPUT_DISK {
    GUID diskId;
    ULONGLONG ullSize;
    GUID plexId;
    DWORD memberIdx;
} VDS_INPUT_DISK;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct VDS_INPUT_DISK
{
    public Guid diskId;
    public ulong ullSize;
    public Guid plexId;
    public uint memberIdx;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure VDS_INPUT_DISK
    Public diskId As Guid
    Public ullSize As ULong
    Public plexId As Guid
    Public memberIdx As UInteger
End Structure
import ctypes
from ctypes import wintypes

class VDS_INPUT_DISK(ctypes.Structure):
    _fields_ = [
        ("diskId", GUID),
        ("ullSize", ctypes.c_ulonglong),
        ("plexId", GUID),
        ("memberIdx", wintypes.DWORD),
    ]
#[repr(C)]
pub struct VDS_INPUT_DISK {
    pub diskId: GUID,
    pub ullSize: u64,
    pub plexId: GUID,
    pub memberIdx: u32,
}
import "golang.org/x/sys/windows"

type VDS_INPUT_DISK struct {
	diskId windows.GUID
	ullSize uint64
	plexId windows.GUID
	memberIdx uint32
}
type
  VDS_INPUT_DISK = record
    diskId: TGUID;
    ullSize: UInt64;
    plexId: TGUID;
    memberIdx: DWORD;
  end;
const VDS_INPUT_DISK = extern struct {
    diskId: GUID,
    ullSize: u64,
    plexId: GUID,
    memberIdx: u32,
};
type
  VDS_INPUT_DISK {.bycopy.} = object
    diskId: GUID
    ullSize: uint64
    plexId: GUID
    memberIdx: uint32
struct VDS_INPUT_DISK
{
    GUID diskId;
    ulong ullSize;
    GUID plexId;
    uint memberIdx;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; VDS_INPUT_DISK サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; diskId : GUID (+0, 16byte)  varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; ullSize : ULONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; plexId : GUID (+24, 16byte)  varptr(st)+24 を基点に操作(16byte:入れ子/配列)
; memberIdx : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; ※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_INPUT_DISK
    #field GUID diskId
    #field int64 ullSize
    #field GUID plexId
    #field int memberIdx
#endstruct

stdim st, VDS_INPUT_DISK        ; NSTRUCT 変数を確保
st->ullSize = 100
mes "ullSize=" + st->ullSize