CIM_USBDevice クラス (CIMWin32 WMI プロバイダー)
CIM_USBDevice クラスは、USB デバイスの管理特性を表します。
重要
DMTF (分散管理タスク フォース) CIM (共通情報モデル) クラスは、WMI クラスが構築される親クラスです。 WMI では現在、 CIM 2.x バージョン スキーマのみがサポートされています。
次の構文は、マネージド オブジェクト形式 (MOF) コードから簡略化され、継承されたすべてのプロパティが含まれています。 プロパティは、MOF の順序ではなく、アルファベット順で一覧表示されます。
構文
[AMENDMENT]
class CIM_USBDevice : CIM_LogicalDevice
{
uint16 Availability;
string Caption;
uint8 ClassCode;
uint32 ConfigManagerErrorCode;
boolean ConfigManagerUserConfig;
string CreationClassName;
uint8 CurrentAlternateSettings[];
uint8 CurrentConfigValue;
string Description;
string DeviceID;
boolean ErrorCleared;
string ErrorDescription;
datetime InstallDate;
uint32 LastErrorCode;
string Name;
uint8 NumberOfConfigs;
string PNPDeviceID;
uint16 PowerManagementCapabilities[];
boolean PowerManagementSupported;
uint8 ProtocolCode;
string Status;
uint16 StatusInfo;
uint8 SubclassCode;
string SystemCreationClassName;
string SystemName;
uint16 USBVersion;
};
メンバー
CIM_USBDevice クラスには、次の種類のメンバーがあります。
メソッド
CIM_USBDevice クラスには、これらのメソッドがあります。
| メソッド | 説明 |
|---|---|
| GetDescriptor | USB デバイス記述子を返します。 WMI によって実装されていません。 |
| リセット | 論理デバイスのリセットを要求します。 WMI によって実装されていません。 |
| SetPowerState | 論理デバイスの必要な電源状態と、デバイスをその状態にするタイミングを定義します。 WMI によって実装されていません。 |
プロパティ
CIM_USBDevice クラスには、これらのプロパティがあります。
-
可用性
-
-
データ型: uint16
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("MIF.DMTF|運用状態|003.5"、"MIB。IETF|HOST-RESOURCES-MIB.hrDeviceStatus")
デバイスの可用性と状態。
このプロパティは、 CIM_LogicalDeviceから継承されます。
-
-
その他 (1)
-
不明 (2)
-
実行中/完全電源 (3)
-
実行中または完全な電源
-
警告 (4)
-
In Test (5)
-
適用なし (6)
-
電源オフ (7)
-
Off Line (8)
-
オフデューティ (9)
-
低下 (10)
-
インストールされていません (11)
-
インストール エラー (12)
-
省電力 - 不明 (13)
-
デバイスは省電力モードであることが知られていますが、正確な状態は不明です。
-
省電力 - 低電力モード (14)
-
デバイスは省電力状態ですが、引き続き機能しており、パフォーマンスが低下する可能性があります。
-
省電力 - スタンバイ (15)
-
デバイスは機能していませんが、すぐに完全な電源に入る可能性があります。
-
電源サイクル (16)
-
省電力 - 警告 (17)
-
ただし、デバイスは警告状態ですが、省電力モードでもあります。
-
一時停止 ( 18)
-
デバイスが一時停止しています。
-
準備ができていません (19)
-
デバイスの準備ができていません。
-
未構成 (20)
-
デバイスが構成されていません。
-
休止 ( 21)
-
デバイスは静かです。
Caption
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MaxLen (64)、 DisplayName ("Caption")
オブジェクトの短いテキスト説明。
このプロパティは、 CIM_ManagedSystemElementから継承されます。
ClassCode
-
データ型: uint8
-
アクセスの種類: 読み取り専用
USB クラス コード。
ConfigManagerErrorCode
-
データ型: uint32
-
アクセスの種類: 読み取り専用
-
修飾子: スキーマ ("Win32")
Win32 Configuration Managerエラー コード。
このプロパティは、 CIM_LogicalDeviceから継承されます。
このデバイスは正常に動作しています。 (0)
デバイスが正常に動作しています。
このデバイスが正しく構成されていません。 (1)
デバイスが正しく構成されていません。
Windows では、このデバイスのドライバーを読み込めません。 (2)
このデバイスのドライバーが破損しているか、システムがメモリやその他のリソースで不足している可能性があります。 (3)
このデバイスのドライバーが破損しているか、システムのメモリやその他のリソースが不足している可能性があります。
このデバイスは正常に動作していません。そのドライバーの 1 つまたはレジストリが破損している可能性があります。 (4)
デバイスが正しく動作していません。 そのドライバーまたはレジストリの 1 つが破損している可能性があります。
このデバイスのドライバーには、Windows で管理できないリソースが必要です。 (5)
デバイスのドライバーには、Windows で管理できないリソースが必要です。
このデバイスのブート構成が他のデバイスと競合しています。 (6)
デバイスのブート構成が他のデバイスと競合しています。
フィルター処理できません。 (7)
デバイスのドライバー ローダーがありません。 (8)
デバイスのドライバー ローダーがありません。
制御ファームウェアがデバイスのリソースを誤って報告しているため、このデバイスは正常に動作していません。 (9)
デバイスが正しく動作していません。 制御ファームウェアが、デバイスのリソースを誤って報告しています。
このデバイスを起動できません。 (10)
デバイスを起動できません。
このデバイスは失敗しました。 (11)
デバイスが失敗しました。
このデバイスは、使用できる十分な空きリソースを見つけることができません。 (12)
デバイスで使用できる十分な空きリソースが見つかりません。
Windows では、このデバイスのリソースを確認できません。 (13)
Windows では、デバイスのリソースを確認できません。
コンピューターを再起動するまで、このデバイスは正常に動作しません。 (14)
コンピューターが再起動されるまで、デバイスは正常に動作しません。
再列挙の問題が発生している可能性があるため、このデバイスは正常に動作していません。 (15)
再列挙の問題が発生したため、デバイスが正常に動作していません。
Windows では、このデバイスが使用するすべてのリソースを識別できません。 (16)
Windows では、デバイスが使用するすべてのリソースを識別できません。
このデバイスは、不明なリソースの種類を要求しています。 (17)
デバイスが不明なリソースの種類を要求しています。
このデバイスのドライバーを再インストールします。 (18)
デバイス ドライバーを再インストールする必要があります。
VxD ローダーを使用してエラーが発生しました。 (19)
レジストリが破損している可能性があります。 (20)
レジストリが破損している可能性があります。
システム エラー: このデバイスのドライバーを変更してみてください。問題が解決しない場合は、ハードウェアのドキュメントを参照してください。Windows はこのデバイスを削除しています。 (21)
システム障害。 デバイス ドライバーを変更しても効果がない場合は、ハードウェアのドキュメントを参照してください。 Windows によってデバイスが削除されています。
このデバイスは無効になっています。 (22)
デバイスが無効になっています。
システム エラー: このデバイスのドライバーを変更してみてください。それでも問題が解決しない場合は、ハードウェアのドキュメントを参照してください。 (23)
システム障害。 デバイス ドライバーを変更しても効果がない場合は、ハードウェアのドキュメントを参照してください。
このデバイスが存在しない、正しく動作していない、またはすべてのドライバーがインストールされていない。 (24)
デバイスが存在しない、正しく動作しない、またはすべてのドライバーがインストールされていない。
Windows はこのデバイスを引き続き設定しています。 (25)
Windows はまだデバイスを設定しています。
Windows はこのデバイスを引き続き設定しています。 (26)
Windows はまだデバイスを設定しています。
このデバイスには有効なログ構成がありません。 (27)
デバイスに有効なログ構成がありません。
このデバイスのドライバーはインストールされていません。 (28)
デバイス ドライバーがインストールされていません。
デバイスのファームウェアで必要なリソースが提供されていないため、このデバイスは無効になっています。 (29)
デバイスが無効になっています。 デバイスファームウェアが必要なリソースを提供しませんでした。
このデバイスは、別のデバイスが使用している割り込み要求 (IRQ) リソースを使用しています。 (30)
デバイスは、別のデバイスが使用している IRQ リソースを使用しています。
Windows はこのデバイスに必要なドライバーを読み込むことができないため、このデバイスが正しく動作していません。 (31)
デバイスが正しく動作していません。 Windows では、必要なデバイス ドライバーを読み込めません。
ConfigManagerUserConfig
-
データ型: boolean
-
アクセスの種類: 読み取り専用
-
修飾子: スキーマ ("Win32")
TRUE の場合、デバイスはユーザー定義の構成を使用します。
このプロパティは 、CIM_LogicalDeviceから継承されます。
CreationClassName
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: CIM_Key
インスタンスの作成で使用されるクラスまたはサブクラスの名前。 クラスの他のキー プロパティと共に使用する場合、このプロパティを使用すると、クラスとそのサブクラスのすべてのインスタンスを一意に識別できます。
このプロパティは 、CIM_LogicalDeviceから継承されます。
CurrentAlternateSettings
-
データ型: uint8 配列
-
アクセスの種類: 読み取り専用
-
修飾子: ModelCorrespondence ("CIM_USBDevice。CurrentConfigValue")
現在選択されている構成の各インターフェイスの USB 代替設定 ( CurrentConfigValue プロパティで示されます)。 この配列には、構成内のインターフェイスごとに 1 つのエントリがあります。 CurrentConfigValue プロパティの値が 0 (ゼロ) の場合、デバイスが構成されていないことを示します。配列は未定義です。 このオクテット文字列の解析の詳細については、USB 仕様を参照してください。
CurrentConfigValue
-
データ型: uint8
-
アクセスの種類: 読み取り専用
-
修飾子: ModelCorrespondence ("CIM_USBDevice。CurrentAlternateSettings")
デバイスで現在選択されている構成。 値が 0 (ゼロ) の場合、デバイスは構成解除されます。
説明
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: DisplayName ("Description")
オブジェクトのテキスト説明。
このプロパティは 、CIM_ManagedSystemElementから継承されます。
DeviceID
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: CIM_Key
論理デバイスに一意の名前を付けるアドレスまたはその他の識別情報。
このプロパティは 、CIM_LogicalDeviceから継承されます。
ErrorCleared
-
データ型: boolean
-
アクセスの種類: 読み取り専用
TRUE の場合、LastErrorCode プロパティで報告されたエラーはクリアされます。
このプロパティは 、CIM_LogicalDeviceから継承されます。
ErrorDescription
-
データ型: string
-
アクセスの種類: 読み取り専用
LastErrorCode プロパティに記録されたエラーと実行する修正アクションに関する情報を提供する自由形式の文字列。
このプロパティは 、CIM_LogicalDeviceから継承されます。
InstallDate
-
データ型: datetime
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("インストール日")
オブジェクトがインストールされた日時。 このプロパティには、オブジェクトがインストールされていることを示す値は必要ありません。
このプロパティは 、CIM_ManagedSystemElementから継承されます。
LastErrorCode
-
データ型: uint32
-
アクセスの種類: 読み取り専用
論理デバイスによって報告された最後のエラー コード。
このプロパティは 、CIM_LogicalDeviceから継承されます。
名前
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: DisplayName ("Name")
オブジェクトが認識されるラベル。 サブクラス化すると、このプロパティをキー プロパティとしてオーバーライドできます。
このプロパティは 、CIM_ManagedSystemElementから継承されます。
NumberOfConfigs
-
データ型: uint8
-
アクセスの種類: 読み取り専用
デバイスに対して定義されているデバイス構成の数。
PNPDeviceID
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: スキーマ ("Win32")
Win32 プラグ アンド プレイ論理デバイスのデバイス識別子。 このプロパティは 、CIM_LogicalDeviceから継承されます。
例: "*PNP030b"
PowerManagementCapabilities
-
データ型: uint16 配列
-
アクセスの種類: 読み取り専用
論理デバイスの特定の電源関連機能の配列。
このプロパティは 、CIM_LogicalDeviceから継承されます。
不明 (0)
サポートされていません (1)
無効 (2)
有効 (3)
電源管理機能は現在有効になっていますが、正確な機能セットが不明であるか、情報が使用できません。
自動的に入力された省電力モード (4)
デバイスは、使用状況やその他の条件に基づいて電源状態を変更できます。
Power State Settable (5)
SetPowerState メソッドがサポートされています。 このメソッドは、親 CIM_LogicalDevice クラスで見つかり、実装できます。 詳細については、「 マネージ オブジェクト形式 (MOF) クラスの設計」を参照してください。
電源循環がサポートされています (6)
SetPowerState メソッドは、PowerState パラメーターを 5 (Power Cycle) に設定して呼び出すことができます。
時間指定電源オンがサポートされています (7)
SetPowerState メソッドは、PowerState パラメーターを 5 (Power Cycle) に設定し、時刻を電源オンの特定の日時または間隔に設定して呼び出すことができます。
PowerManagementSupported
-
データ型: boolean
-
アクセスの種類: 読み取り専用
TRUE の場合、デバイスは電源を管理できます。つまり、節電状態になります。 FALSE の場合、PowerManagementCapabilities 配列の唯一のエントリは整数値 1 ("サポートされていません") である必要があります。
このプロパティは、電源管理機能が現在有効になっているか、有効になっている場合は、どの機能がサポートされているかを示しません。 詳細については、「 PowerManagementCapabilities 配列」を参照してください。 このプロパティは 、CIM_LogicalDeviceから継承されます。
ProtocolCode
-
データ型: uint8
-
アクセスの種類: 読み取り専用
USB プロトコル コード。
状態
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MaxLen (10)、 DisplayName ("Status")
オブジェクトの現在の状態。 このプロパティは 、CIM_ManagedSystemElementから継承されます。
次の値があります。
OK ("OK")
エラー ("Error")
機能低下 ("Degraded")
不明 ("不明")
Pred Fail ("Pred Fail")
開始 中 ("Starting")
停止 中 ("停止中")
サービス ("Service")
ストレス ( "ストレス")
NonRecover ("NonRecover")
連絡先なし ("連絡先なし")
Lost Comm ("Lost Comm")
StatusInfo
-
データ型: uint16
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("MIF.DMTF|運用状態|003.3")
論理デバイスの状態。 このプロパティが論理デバイスに適用されない場合は、値 5 (適用できません) を使用する必要があります。
このプロパティは 、CIM_LogicalDeviceから継承されます。
その他 (1)
不明 (2)
有効 (3)
無効 (4)
該当なし (5)
サブクラスコード
-
データ型: uint8
-
アクセスの種類: 読み取り専用
USB サブクラス コード。
SystemCreationClassName
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: 伝達 ( "CIM_System。CreationClassName")) 、CIM_Key
スコープ システムの作成クラス名。
このプロパティは 、CIM_LogicalDeviceから継承されます。
Systemname
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: 伝達 ( "CIM_System。Name") )、CIM_Key
スコープ システムの名前。
このプロパティは 、CIM_LogicalDeviceから継承されます。
USBVersion
-
データ型: uint16
-
アクセスの種類: 読み取り専用
USB デバイスでサポートされている最新の USB バージョン。 このプロパティは、2 番目と 3 番目の数字の間に小数点が暗黙的に指定される、バイナリ コード化された 10 進数 (BCD) として表されます。 たとえば、0x201 の値は、バージョン 2.01 がサポートされていることを示します。
解説
CIM_USBDevice クラスは、CIM_LogicalDeviceから派生します。
WMI では、このクラスは実装されません。 CIM_USBDeviceを実装する WMI クラスについては、「Win32 クラス」を参照してください。
このドキュメントは、DMTF によって発行された CIM クラスの説明から派生しています。 Microsoft は、軽微なエラーの修正、Microsoft SDK ドキュメント標準への準拠、または詳細情報の提供を行うために変更を加えた可能性があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| 名前空間 |
Root\CIMV2 |
| MOF |
|
| [DLL] |
|