ホーム › Storage.VirtualDiskService › IVdsLunControllerPorts
IVdsLunControllerPorts
COM公式ドキュメント
IVdsLunControllerPorts インターフェイス (vdshwprv.h) は、LUN 上でコントローラーポートの構成操作を実行するためのメソッドを提供します。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT AssociateControllerPorts(GUID* pActiveControllerPortIdArray, INT lNumberOfActiveControllerPorts, GUID* pInactiveControllerPortIdArray, INT lNumberOfInactiveControllerPorts)
IVdsLunControllerPorts::AssociateControllerPorts (vdshwprv.h) メソッドは、LUN に対してサブシステムのコントローラーポートをアクティブまたは非アクティブに設定します。
| pActiveControllerPortIdArray | GUID* | in | コントローラーポートの GUID の配列へのポインター。プロバイダーはこれらのコントローラーポートをアクティブに設定します。この配列には、既にアクティブに設定されており、アクティブのまま維持されるコントローラーポートも含まれます。 |
| lNumberOfActiveControllerPorts | INT | in | pActiveControllerPortIdArray パラメーターで指定されるコントローラーポートの数。 |
| pInactiveControllerPortIdArray | GUID* | in | コントローラーポートの GUID の配列へのポインター。プロバイダーはこれらのコントローラーポートを非アクティブに設定します。この配列には、既に非アクティブに設定されており、非アクティブのまま維持されるコントローラーポートも含まれます。 |
| lNumberOfInactiveControllerPorts | INT | in | pInactiveControllerPortIdArray パラメーターで指定されるコントローラーポートの数。 |
戻り値
このメソッドは、E_INVALIDARG や E_OUTOFMEMORY などの標準の HRESULT 値のほか、VDS 固有の戻り値を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換されたシステムエラーコードを返すこともあります。エラーは VDS 自体、または使用中の基盤となる VDS プロバイダーから発生する可能性があります。返される可能性のある値には次のものが含まれます。
| リターンコード/値 | 説明 |
|---|---|
| 関連付け名が正常に設定されました。 | |
|
プロバイダーのキャッシュが破損しています。これは、接続されているデバイスに関する情報をキャッシュするプロバイダー内部で、ソフトウェアまたは通信の問題が発生していることを示します。呼び出し元は、IVdsHwProvider::Reenumerate メソッドに続けて IVdsHwProvider::Refresh メソッドを使用して、キャッシュを復元できます。 |
|
LUN オブジェクトは既に存在しません。 |
|
LUN が失敗状態にあり、要求された操作を実行できません。 |
|
別の操作が進行中です。この操作は、以前の操作が完了するまで続行できません。 |
|
pActiveControllerPortIdArray または pInactiveControllerPortIdArray パラメーターで指定された、データ型 VDS_OBJECT_ID の 1 つ以上の GUID が、既存のオブジェクトを参照していません。 |
|
この操作またはパラメーターの組み合わせは、このプロバイダーではサポートされていません。 |
vtbl 4 HRESULT QueryActiveControllerPorts(IEnumVdsObject** ppEnum)
IVdsLunControllerPorts::QueryActiveControllerPorts (vdshwprv.h) メソッドは、現在アクティブなコントローラーポートの列挙を返します。
| ppEnum | IEnumVdsObject** | out | コントローラーポートをコントローラーポートオブジェクトとして列挙するために使用できる IEnumVdsObject インターフェイスポインターのアドレス。詳細については、「列挙オブジェクトの操作」を参照してください。呼び出し元は、インターフェイスおよび各コントローラーポートオブジェクトが不要になったときに、IUnknown::Release メソッドを呼び出して解放する必要があります。 |
戻り値
このメソッドは、E_INVALIDARG や E_OUTOFMEMORY などの標準の HRESULT 値のほか、VDS 固有の戻り値を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換されたシステムエラーコードを返すこともあります。エラーは VDS 自体、または使用中の基盤となる VDS プロバイダーから発生する可能性があります。返される可能性のある値には次のものが含まれます。
| リターンコード/値 | 説明 |
|---|---|
| コントローラーポートの列挙が正常に返されました。LUN にアクティブなコントローラーポートがない場合、列挙は空になります。 | |
|
プロバイダーのキャッシュが破損しています。これは、接続されているデバイスに関する情報をキャッシュするプロバイダー内部で、ソフトウェアまたは通信の問題が発生していることを示します。呼び出し元は、IVdsHwProvider::Reenumerate メソッドに続けて IVdsHwProvider::Refresh メソッドを使用して、キャッシュを復元できます。 |
|
LUN オブジェクトは既に存在しません。 |
|
LUN が失敗状態にあり、要求された操作を実行できません。 |
|
別の操作が進行中です。この操作は、以前の操作が完了するまで続行できません。 |
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IVdsLunControllerPorts "{451FE266-DA6D-406A-BB60-82E534F85AEB}" #usecom global IVdsLunControllerPorts IID_IVdsLunControllerPorts "{}" #comfunc global IVdsLunControllerPorts_AssociateControllerPorts 3 var,int,var,int #comfunc global IVdsLunControllerPorts_QueryActiveControllerPorts 4 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IVdsLunControllerPorts "{451FE266-DA6D-406A-BB60-82E534F85AEB}" #usecom global IVdsLunControllerPorts IID_IVdsLunControllerPorts "{}" #comfunc global IVdsLunControllerPorts_AssociateControllerPorts 3 sptr,int,sptr,int #comfunc global IVdsLunControllerPorts_QueryActiveControllerPorts 4 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。