次の方法で共有

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
Wmcodecdsp.h
MOF
CIMWin32.mof
[DLL]
CIMWin32.dll

こちらもご覧ください

CIM_USBHub

CIM_USBHub