ホーム › Storage.VirtualDiskService › IVdsMaintenance

IVdsMaintenance

COM

📘 Microsoft Learn (日本語) · English

IIDdaebeef3-8523-47ed-a2b9-05cecce2a1ae継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IVdsMaintenance インターフェイス (vdshwprv.h) は、サブシステム、コントローラー、LUN、またはドライブに対してメンテナンス操作を実行するためのメソッドを提供します。

メソッド 3

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

vtbl 3 HRESULT StartMaintenance(VDS_MAINTENANCE_OPERATION operation)

IVdsMaintenance::StartMaintenance (vdshwprv.h) メソッドは、メンテナンス操作を開始します。

operation

VDS_MAINTENANCE_OPERATION

VDS_MAINTENANCE_OPERATION によって列挙されるメンテナンス操作。

戻り値

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

リターンコード/値	説明
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	この戻り値は、アレイに関する情報をキャッシュするプロバイダー内部でのソフトウェアまたは通信の問題を示します。キャッシュを復元するには、IVdsHwProvider::Reenumerate メソッドを実行し、続けて IVdsHwProvider::Refresh メソッドを実行してください。
VDS_E_OBJECT_DELETED 0x8004240BL	サブシステムオブジェクトは既に存在しません。
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	サブシステムが失敗状態にあり、要求された操作を実行できません。
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	別の操作が進行中です。この操作は、先行する操作が完了するまで続行できません。
VDS_E_NOT_SUPPORTED 0x80042400L	この操作、またはパラメーターの組み合わせは、このプロバイダーではサポートされていません。

解説(Remarks)

操作は、いったん開始されると、呼び出し元が StopMaintenance メソッドまたは PulseMaintenance メソッドを呼び出すまで実行され続けます。実行中の操作に対して StopMaintenance が呼び出されると、操作は直ちに停止します。実行中の操作に対して PulseMaintenance が呼び出されると、操作は指定された回数だけパルス動作を行った後に停止します。

パルス動作中の操作に対して StartMaintenance を呼び出すと、操作が開始され、StopMaintenance が呼び出されて停止されるか、PulseMaintenance が呼び出されて再びパルス動作に設定されるまで実行され続けます。

vtbl 4 HRESULT StopMaintenance(VDS_MAINTENANCE_OPERATION operation)

IVdsMaintenance::StopMaintenance (vdshwprv.h) メソッドは、メンテナンス操作を停止します。

operation

VDS_MAINTENANCE_OPERATION

VDS_MAINTENANCE_OPERATION によって列挙されるメンテナンス操作。

戻り値

リターンコード/値	説明
S_FALSE	指定されたメンテナンス操作は実行されていません。このメソッドは何も行いません。
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	この戻り値は、アレイに関する情報をキャッシュするプロバイダー内部でのソフトウェアまたは通信の問題を示します。キャッシュを復元するには、IVdsHwProvider::Reenumerate メソッドを実行し、続けて IVdsHwProvider::Refresh メソッドを実行してください。
VDS_E_OBJECT_DELETED 0x8004240BL	サブシステムオブジェクトは既に存在しません。
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	サブシステムが失敗状態にあり、要求された操作を実行できません。
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	別の操作が進行中です。この操作は、先行する操作が完了するまで続行できません。
VDS_E_NOT_SUPPORTED 0x80042400L	この操作、またはパラメーターの組み合わせは、このプロバイダーではサポートされていません。

vtbl 5 HRESULT PulseMaintenance(VDS_MAINTENANCE_OPERATION operation, DWORD ulCount)

IVdsMaintenance::PulseMaintenance (vdshwprv.h) メソッドは、指定された操作を指定された回数だけ実行します。

operation	VDS_MAINTENANCE_OPERATION	in	VDS_MAINTENANCE_OPERATION によって列挙されるメンテナンス操作。
ulCount	DWORD	in	操作を実行する回数。

戻り値

リターンコード/値	説明
S_FALSE	指定された操作は実行されていません。このメソッドは何も行いません。
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	この戻り値は、アレイに関する情報をキャッシュするプロバイダー内部でのソフトウェアまたは通信の問題を示します。キャッシュを復元するには、IVdsHwProvider::Reenumerate メソッドを実行し、続けて IVdsHwProvider::Refresh メソッドを実行してください。
VDS_E_OBJECT_DELETED 0x8004240BL	サブシステムオブジェクトは既に存在しません。
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	サブシステムが失敗状態にあり、要求された操作を実行できません。
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	別の操作が進行中です。この操作は、先行する操作が完了するまで続行できません。
VDS_E_NOT_SUPPORTED 0x80042400L	この操作、またはパラメーターの組み合わせは、このプロバイダーではサポートされていません。

解説(Remarks)

操作が既に実行中の場合、このメソッドはその操作を指定された回数だけパルス動作させた後に停止させます。操作がパルス動作を行う間隔は、プロバイダーによって定義されます。このメソッドは、SpinDown 操作または SpinUp 操作では使用できません。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IVdsMaintenance "{DAEBEEF3-8523-47ED-A2B9-05CECCE2A1AE}"
#usecom global IVdsMaintenance IID_IVdsMaintenance "{}"
#comfunc global IVdsMaintenance_StartMaintenance  3 int
#comfunc global IVdsMaintenance_StopMaintenance   4 int
#comfunc global IVdsMaintenance_PulseMaintenance  5 int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。