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

IVdsStoragePool

COM
📘 Microsoft Learn (日本語) · English
IID932ca8cf-0eb3-4ba8-9620-22665d7f8450継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IVdsStoragePool インターフェイス (vdshwprv.h) は、記憶域プールに関する情報の照会や関連オブジェクトの列挙を行うためのメソッドを提供します。

メソッド 6

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetProvider(IVdsProvider** ppProvider)

IVdsStoragePool::GetProvider (vdshwprv.h) メソッドは、記憶域プールを管理するハードウェアプロバイダーを返します。

ppProviderIVdsProvider**outIVdsProvider インターフェイスポインターを受け取る変数のアドレスです。呼び出し側は、このインターフェイスが不要になったときに IUnknown::Release メソッドを呼び出して解放する必要があります。

戻り値

このメソッドは、E_INVALIDARG や E_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換されたシステムエラーコードを返すこともあります。エラーは、VDS 自体、または使用されている基盤の VDS プロバイダーから発生する可能性があります。戻り値には次のものが含まれます。

戻り値 説明
S_OK
 メソッドは正常に完了しました。
vtbl 4 HRESULT GetProperties(VDS_STORAGE_POOL_PROP* pStoragePoolProp)

IVdsStoragePool::GetProperties (vdshwprv.h) メソッドは、記憶域プールのプロパティを返します。

pStoragePoolPropVDS_STORAGE_POOL_PROP*out記憶域プールのプロパティ情報を受け取る、呼び出し側が割り当てた VDS_STORAGE_POOL_PROP 構造体のアドレスです。

戻り値

このメソッドは、E_INVALIDARG や E_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換されたシステムエラーコードを返すこともあります。エラーは、VDS 自体、または使用されている基盤の VDS プロバイダーから発生する可能性があります。戻り値には次のものが含まれます。

戻り値 説明
S_OK
 メソッドは正常に完了しました。
vtbl 5 HRESULT GetAttributes(VDS_POOL_ATTRIBUTES* pStoragePoolAttributes)

IVdsStoragePool::GetAttributes (vdshwprv.h) メソッドは、記憶域プールの属性を返します。

pStoragePoolAttributesVDS_POOL_ATTRIBUTES*out記憶域プールの属性を受け取る、呼び出し側が割り当てた VDS_POOL_ATTRIBUTES 構造体のアドレスです。

戻り値

このメソッドは、E_INVALIDARG や E_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換されたシステムエラーコードを返すこともあります。エラーは、VDS 自体、または使用されている基盤の VDS プロバイダーから発生する可能性があります。戻り値には次のものが含まれます。

戻り値 説明
S_OK
 メソッドは正常に完了しました。
vtbl 6 HRESULT QueryDriveExtents(VDS_STORAGE_POOL_DRIVE_EXTENT** ppExtentArray, INT* plNumberOfExtents)

IVdsStoragePool::QueryDriveExtents (vdshwprv.h) メソッドは、記憶域プールで使用されているドライブエクステントの配列を返します。

ppExtentArrayVDS_STORAGE_POOL_DRIVE_EXTENT**out呼び出し側から渡される VDS_STORAGE_POOL_DRIVE_EXTENT 構造体の配列へのポインターです。これらの構造体は、記憶域プールで使用されるドライブエクステントを記述します。呼び出し側は、CoTaskMemFree 関数を使用してこの配列を解放する必要があります。
plNumberOfExtentsINT*outppExtentArray 配列で返されるエクステントの数へのポインターです。

戻り値

このメソッドは、E_INVALIDARG や E_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換されたシステムエラーコードを返すこともあります。エラーは、VDS 自体、または使用されている基盤の VDS プロバイダーから発生する可能性があります。戻り値には次のものが含まれます。

戻り値 説明
S_OK
 メソッドは正常に完了しました。
vtbl 7 HRESULT QueryAllocatedLuns(IEnumVdsObject** ppEnum)

IVdsStoragePool::QueryAllocatedLuns (vdshwprv.h) メソッドは、記憶域プールに割り当てられた LUN を列挙するオブジェクトを返します。

ppEnumIEnumVdsObject**out割り当てられた LUN の列挙に使用できる IEnumVdsObject インターフェイス ポインターのアドレスです。詳細については、「列挙オブジェクトの操作」を参照してください。呼び出し側は、インターフェイスおよび各 LUN オブジェクトが不要になったときに IUnknown::Release メソッドを呼び出して解放する必要があります。

戻り値

このメソッドは、E_INVALIDARG や E_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換されたシステムエラーコードを返すこともあります。エラーは、VDS 自体、または使用されている基盤の VDS プロバイダーから発生する可能性があります。戻り値には次のものが含まれます。

戻り値 説明
S_OK
 メソッドは正常に完了しました。
vtbl 8 HRESULT QueryAllocatedStoragePools(IEnumVdsObject** ppEnum)

IVdsStoragePool::QueryAllocatedStoragePools メソッドは、プロバイダーが管理する、割り当てられた記憶域プールを列挙するオブジェクトを返します。

ppEnumIEnumVdsObject**out割り当てられた記憶域プールの列挙に使用できる IEnumVdsObject インターフェイス ポインターのアドレスです。詳細については、「列挙オブジェクトの操作」を参照してください。呼び出し側は、インターフェイスおよび各記憶域プールオブジェクトが不要になったときに IUnknown::Release メソッドを呼び出して解放する必要があります。

戻り値

このメソッドは、E_INVALIDARG や E_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換されたシステムエラーコードを返すこともあります。エラーは、VDS 自体、または使用されている基盤の VDS プロバイダーから発生する可能性があります。戻り値には次のものが含まれます。

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

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IVdsStoragePool "{932CA8CF-0EB3-4BA8-9620-22665D7F8450}"
#usecom global IVdsStoragePool IID_IVdsStoragePool "{}"
#comfunc global IVdsStoragePool_GetProvider                 3 sptr
#comfunc global IVdsStoragePool_GetProperties               4 var
#comfunc global IVdsStoragePool_GetAttributes               5 var
#comfunc global IVdsStoragePool_QueryDriveExtents           6 var,var
#comfunc global IVdsStoragePool_QueryAllocatedLuns          7 sptr
#comfunc global IVdsStoragePool_QueryAllocatedStoragePools  8 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。