CIM_USBDevice クラスの GetDescriptor メソッド (Wmcodecdsp.h)

GetDescriptor メソッドは、入力パラメーターで指定された USB デバイス記述子を返します。

このトピックでは、マネージド オブジェクト形式 (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]

入力時に、返される記述子の長さ (オクテット単位)。 この値が記述子の実際の長さより小さい場合は、要求された長さのみが返されます。 実際の長さを超える場合は、実際の長さが返されます。

出力時に、返されるバッファーの長さ (オクテット単位)。 要求された記述子が存在しない場合、このパラメーターの内容は未定義です。

バッファー [out]

要求された記述子情報を返します。 記述子が存在しない場合、このパラメーターの内容は未定義です。

戻り値

USB 記述子が正常に返された場合は 0 (ゼロ)、要求がサポートされていない場合は 1 (1)、エラーを示すその他の数値を返します。 サブクラスでは、 メソッドの ValueMap 修飾子を使用して、使用可能なリターン コードのセットを指定できます。 mofqualifier の内容が変換される文字列は、サブクラスで Values 配列修飾子として指定することもできます。

注釈

このメソッドは現在、WMI では実装されていません。 このメソッドを使用するには、独自のプロバイダーに実装する必要があります。

このドキュメントは、DMTF によって発行された CIM クラスの説明から派生しています。 Microsoft は、軽微なエラーの修正、Microsoft SDK ドキュメント標準への準拠、または詳細情報の提供を行うために変更を加えた可能性があります。

要件

こちらもご覧ください

CIM_USBDevice

CIM_USBDevice