CIM_Controller クラス (CIMWin32 WMI プロバイダー)
CIM_Controller クラスは、その他のコントロール関連デバイスをグループ化するための親クラスです。 コントローラーの例としては、SCSI コントローラー、USB コントローラー、シリアル コントローラーがあります。
CIM_Controller クラスは、1 つのプロトコル スタックを持つデバイスの抽象化であり、主にダウンストリーム (CIM_ControlledBy) デバイスとの通信と制御またはリセットのために存在します。
重要
DMTF (分散管理タスク フォース) CIM (共通情報モデル) クラスは、WMI クラスが構築される親クラスです。 WMI では現在、 CIM 2.x バージョン スキーマのみがサポートされています。
次の構文は、マネージド オブジェクト フォーマット (MOF) コードを簡素化しており、継承されたすべてのプロパティを含んでいます。 プロパティは、MOF の順序ではなく、アルファベット順に一覧表示されます。
構文
[Abstract, UUID("{8502C531-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_Controller : CIM_LogicalDevice
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
uint16 Availability;
uint32 ConfigManagerErrorCode;
boolean ConfigManagerUserConfig;
string CreationClassName;
string DeviceID;
uint16 PowerManagementCapabilities[];
boolean ErrorCleared;
string ErrorDescription;
uint32 LastErrorCode;
string PNPDeviceID;
boolean PowerManagementSupported;
uint16 StatusInfo;
string SystemCreationClassName;
string SystemName;
uint32 MaxNumberControlled;
uint16 ProtocolSupported;
datetime TimeOfLastReset;
};
メンバー
CIM_Controller クラスには、次の種類のメンバーがあります。
メソッド
CIM_Controller クラスには、これらのメソッドがあります。
| メソッド | 説明 |
|---|---|
| リセット | 論理デバイスのリセットを要求します。 WMI によって実装されていません。 |
| SetPowerState | 論理デバイスの目的の電源状態と、デバイスをその状態にする必要があるタイミングを定義します。 WMI によって実装されていません。 |
プロパティ
CIM_Controller クラスには、これらのプロパティがあります。
-
可用性
-
-
データ型: 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から継承されます。
ConfigManagerErrorCode
-
データ型: uint32
-
アクセスの種類: 読み取り専用
-
修飾子: スキーマ ("Win32")
Win32 Configuration Managerエラー コード。
このプロパティは 、CIM_LogicalDeviceから継承されます。
このデバイスは正常に動作しています。 (0)
このデバイスが正しく構成されていません。 (1)
Windows では、このデバイスのドライバーを読み込めません。 (2)
このデバイスのドライバーが破損しているか、システムがメモリやその他のリソースで不足している可能性があります。 (3)
このデバイスは正常に動作していません。 そのドライバーまたはレジストリの 1 つが破損している可能性があります。 (4)
このデバイスのドライバーには、Windows で管理できないリソースが必要です。 (5)
このデバイスのブート構成が他のデバイスと競合しています。 (6)
フィルター処理できません。 (7)
デバイスのドライバー ローダーがありません。 (8)
制御ファームウェアがデバイスのリソースを誤って報告しているため、このデバイスが正しく動作していません。 (9)
このデバイスを起動できません。 (10)
このデバイスは失敗しました。 (11)
このデバイスは、使用できる十分な空きリソースを見つけることができません。 (12)
Windows では、このデバイスのリソースを確認できません。 (13)
コンピューターを再起動するまで、このデバイスは正常に動作しません。 (14)
再列挙の問題が発生している可能性があるため、このデバイスは正常に動作していません。 (15)
Windows では、このデバイスが使用するすべてのリソースを識別できません。 (16)
このデバイスは、不明なリソースの種類を要求しています。 (17)
このデバイスのドライバーを再インストールします。 (18)
VxD ローダーを使用してエラーが発生しました。 (19)
レジストリが破損している可能性があります。 (20)
システム エラー: このデバイスのドライバーを変更してみてください。 問題が解決しない場合は、ハードウェアのドキュメントを参照してください。 Windows はこのデバイスを削除しています。 (21)
このデバイスは無効になっています。 (22)
システム エラー: このデバイスのドライバーを変更してみてください。 それでも問題が解決しない場合は、ハードウェアのドキュメントを参照してください。 (23)
このデバイスが存在しない、正しく動作していない、またはすべてのドライバーがインストールされていない。 (24)
Windows はこのデバイスを引き続き設定しています。 (25)
Windows はこのデバイスを引き続き設定しています。 (26)
このデバイスには有効なログ構成がありません。 (27)
このデバイスのドライバーはインストールされていません。 (28)
デバイスのファームウェアで必要なリソースが提供されていないため、このデバイスは無効になっています。 (29)
このデバイスは、別のデバイスが使用している割り込み要求 (IRQ) リソースを使用しています。 (30)
Windows はこのデバイスに必要なドライバーを読み込むことができないため、このデバイスが正しく動作していません。 (31)
ConfigManagerUserConfig
-
データ型: boolean
-
アクセスの種類: 読み取り専用
-
修飾子: スキーマ ("Win32")
TRUE の場合、デバイスはユーザー定義の構成を使用します。
このプロパティは 、CIM_LogicalDeviceから継承されます。
CreationClassName
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: CIM_Key
インスタンスの作成で使用されるクラスまたはサブクラスの名前。 クラスの他のキー プロパティと共に使用する場合、このプロパティを使用すると、クラスとそのサブクラスのすべてのインスタンスを一意に識別できます。
このプロパティは 、CIM_LogicalDeviceから継承されます。
説明
-
データ型: 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から継承されます。
MaxNumberControlled
-
データ型: uint32
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("MIF.DMTF|バス ポート|001.9")
このコントローラーでサポートされている直接アドレス指定可能なエンティティの最大数。 数値が不明または無制限の場合は、値 0 を使用する必要があります。
名前
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: DisplayName ("Name")
オブジェクトが認識されるラベル。 サブクラス化すると、このプロパティをキー プロパティとしてオーバーライドできます。
このプロパティは 、CIM_ManagedSystemElementから継承されます。
PNPDeviceID
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: スキーマ ("Win32")
論理デバイスの Win32 プラグ アンド プレイデバイス識別子を示します。
例: "*PNP030b"
このプロパティは 、CIM_LogicalDeviceから継承されます。
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") に設定し、Time パラメーターを電源オンの特定の日時または間隔に設定して呼び出すことができます。
PowerManagementSupported
-
データ型: boolean
-
アクセスの種類: 読み取り専用
TRUE の場合、デバイスは電源を管理できます。つまり、節電状態になります。 FALSE の場合、PowerManagementCapabilities 配列の唯一のエントリは整数値 1 ("サポートされていません") である必要があります。
このプロパティは、電源管理機能が現在有効になっているか、有効になっている場合は、どの機能がサポートされているかを示しません。 詳細については、「 PowerManagementCapabilities 配列」を参照してください。
このプロパティは 、CIM_LogicalDeviceから継承されます。
ProtocolSupported
-
データ型: uint16
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("MIF.DMTF|バス ポート|001.2","MIF.DMTF|ディスク|003.3")
コントローラーが "制御された" デバイスにアクセスするために使用するプロトコル。
その他 (1)
不明 (2)
EISA (3)
ISA (4)
PCI (5)
ATA/ATAPI (6)
フレキシブル ディスケット (7)
1496 (8)
SCSI 並列インターフェイス (9)
SCSI ファイバー チャネル プロトコル (10)
SCSI シリアル バス プロトコル (11)
SCSI シリアル バス プロトコル 2 (1394) (12)
SCSI シリアル ストレージ アーキテクチャ (13)
VESA (14)
PCMCIA (15)
ユニバーサル シリアル バス (16)
並列プロトコル (17)
ESCON (18)
診断 (19)
I2C (20)
Power (21)
HIPPI (22)
MultiBus (23)
VME (24)
IPI (25)
IEEE-488 (26)
RS232 (27)
IEEE 802.3 10BASE5 (28)
IEEE 802.3 10BASE2 (29)
IEEE 802.3 1BASE5 (30)
IEEE 802.3 10BROAD36 (31)
IEEE 802.3 100BASEVG (32)
IEEE 802.5 トークン リング (33)
ANSI X3T9.5 FDDI (34)
MCA (35)
ESDI (36)
IDE (37)
CMD (38)
ST506 (39)
DSSI (40)
QIC2 (41)
拡張 ATA/IDE (42)
AGP (43)
TWIRP (双方向赤外線) (44)
FIR (高速赤外線) (45)
SIR (シリアル赤外線) (46)
IrBus (47)
状態
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MaxLen (10)、 DisplayName ("Status")
オブジェクトの現在の状態を示す文字列。 操作状態と非運用状態を定義できます。 運用状態には、"OK"、"機能低下"、"Pred Fail" を含めることができます。 "Pred Fail" は、要素が正しく機能しているが、エラー (SMART 対応ハード ディスク ドライブなど) を予測していることを示します。
非運用状態には、"エラー"、"開始中"、"停止中"、および "サービス" が含まれる場合があります。 "サービス" は、ディスクミラー再チェックイン、ユーザーアクセス許可リストの再読み込み、またはその他の管理作業中に適用できます。 このような作業のすべてがオンラインであるわけではありませんが、マネージド要素は "OK" でも、他の状態の 1 つでもありません。
このプロパティは 、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 ("Not Applicable") を使用する必要があります。
このプロパティは 、CIM_LogicalDeviceから継承されます。
その他 (1)
不明 (2)
有効 (3)
無効 (4)
該当なし (5)
SystemCreationClassName
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: 伝達 ( "CIM_System。CreationClassName")) 、CIM_Key
スコープ システムの作成クラス名。
このプロパティは 、CIM_LogicalDeviceから継承されます。
Systemname
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: 伝達 ( "CIM_System。Name") )、CIM_Key
スコープ システムの名前。
このプロパティは 、CIM_LogicalDeviceから継承されます。
TimeOfLastReset
-
データ型: datetime
-
アクセスの種類: 読み取り専用
コントローラーが最後にリセットされた日時 (電源が切れているか、再初期化されました)。
注釈
CIM_Controller クラスは、CIM_LogicalDeviceから派生します。
WMI では、このクラスは実装されません。 CIM_Controllerから派生したクラスについては、「Win32 クラス」を参照してください。
このドキュメントは、DMTF によって発行された CIM クラスの説明から派生しています。 Microsoft は、軽微なエラーの修正、Microsoft SDK ドキュメント標準への準拠、または詳細情報の提供を行うために変更を加えた可能性があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| 名前空間 |
Root\CIMV2 |
| MOF |
|
| [DLL] |
|