CIM_USBHub クラスの GetDescriptor メソッド
GetDescriptor メソッドは、入力パラメーターで指定された USB ハブ記述子を返します。
重要
DMTF (分散管理タスク フォース) CIM (共通情報モデル) クラスは、WMI クラスが構築される親クラスです。 WMI では現在、 CIM 2.x バージョン スキーマのみがサポートされています。
このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。
構文
uint32 GetDescriptor(
[in] uint8 RequestType,
[in] uint16 RequestValue,
[in] uint16 RequestIndex,
[in, out] uint16 RequestLength,
[out] uint8 Buffer[]
);
パラメーター
-
RequestType [in]
-
記述子要求の種類と受信者のビット マップ識別子。 各ビットの適切な値については、USB 仕様を参照してください。
-
RequestValue [in]
-
高バイトの記述子型と、記述子インデックス (記述子配列へのインデックスやオフセットなど) を下位バイトに格納します。 詳細については、USB 仕様に関するページを参照してください。
-
RequestIndex [in]
-
文字列記述子データを返すときに USB デバイスで使用される 2 バイト言語識別子コードを指定します。 パラメーターは通常、文字列以外の記述子の場合は 0 (ゼロ) です。 詳細については、USB 仕様に関するページを参照してください。
-
RequestLength [in, out]
-
入力時に返される記述子の長さ (オクテット単位)。 この値が記述子の実際の長さより小さい場合は、要求された長さのみが返されます。 実際の長さを超える場合は、実際の長さが返されます。
出力時に、返されるバッファーの長さ (オクテット単位)。 要求された記述子が存在しない場合、このパラメーターの内容は未定義です。
-
Buffer [out]
-
Buffer は、要求された記述子情報を返します。 記述子が存在しない場合、バッファーの内容は未定義です。
戻り値
USB 記述子が正常に返された場合は 0 (ゼロ)、要求がサポートされていない場合は 1 (1)、エラーを示すその他の数値を返します。 サブクラスでは、 メソッドの ValueMap 修飾子を使用して、可能なリターン コードのセットを指定できます。 mofqualifier の内容が変換される文字列は、サブクラスで Values 配列修飾子として指定することもできます。
注釈
現在、このメソッドは WMI によって実装されていません。 このメソッドを使用するには、独自のプロバイダーに実装する必要があります。
このドキュメントは、DMTF によって公開されている CIM クラスの説明から派生しています。 Microsoft は、軽微なエラーを修正したり、Microsoft SDK ドキュメントの標準に準拠したり、詳細情報を提供したりするために変更を加えた可能性があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| 名前空間 |
Root\CIMV2 |
| Header |
|
| MOF |
|
| [DLL] |
|