classe CIM_Controller (fournisseurs WMI CIMWin32)

Article
07/03/2023

La classe CIM_Controller est une classe parente pour regrouper divers appareils liés au contrôle. Les contrôleurs SCSI, les contrôleurs USB et les contrôleurs série sont des exemples de contrôleurs.

La classe CIM_Controller est une abstraction pour les appareils dotés d’une pile de protocoles unique, qui existent principalement pour la communication et le contrôle ou la réinitialisation d’appareils en aval (CIM_ControlledBy).

Important

Les classes CIM (Common Information Model) DMTF (Distributed Management Task Force) sont les classes parentes sur lesquelles les classes WMI sont créées. WMI prend actuellement en charge uniquement les schémas de version CIM 2.x.

La syntaxe suivante est simplifiée à partir de code au format MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées dans l’ordre alphabétique, et non dans l’ordre MOF.

Syntaxe

[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;
};

Membres

La classe CIM_Controller a les types de membres suivants :

Méthodes
Propriétés

Méthodes

La classe CIM_Controller possède ces méthodes.

Méthode	Description
Réinitialiser	Demande une réinitialisation de l’appareil logique. Non implémenté par WMI.
SetPowerState	Définit l’état d’alimentation souhaité pour un appareil logique et le moment où un appareil doit être placé dans cet état. Non implémenté par WMI.

Propriétés

La classe CIM_Controller possède ces propriétés.

Disponibilité

Type de données : uint16
Type d'accès : Lecture seule
Qualificateurs : MappingStrings (« MIF. DMTF| État opérationnel|003.5 », « MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus »)

Disponibilité et status de l’appareil.

Cette propriété est héritée de CIM_LogicalDevice.

Autre (1)

Inconnu (2)

En cours d’exécution/pleine puissance (3)

Avertissement (4)

Dans le test (5)

Non applicable (6)

Mise hors tension (7)

Hors ligne (8)

Hors service (9)

Dégradé ( 10)

Non installé (11)

Erreur d’installation (12)

Power Save - Inconnu (13)

L’appareil est connu pour être en mode d’économie d’énergie, mais son status exact est inconnu.

Économie d’énergie - Mode Faible consommation (14)

L’appareil est dans un état d’économie d’énergie, mais il fonctionne toujours et peut présenter des performances dégradées.

Économie d’énergie - Veille (15)

L’appareil ne fonctionne pas, mais peut être rapidement mis à pleine puissance.

Cycle d’alimentation (16)

Power Save - Avertissement (17)

L’appareil est dans un état d’avertissement, mais également en mode économie d’énergie.

Suspendu (18)

L’appareil est suspendu.

Non prêt (19)

Le périphérique n’est pas prêt.

Non configuré (20)

L’appareil n’est pas configuré.

Quiesced (21)

L’appareil est silencieux.

Caption

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : MaxLen (64), DisplayName (« Caption »)

Brève description textuelle de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

ConfigManagerErrorCode

Type de données : uint32
Type d'accès : Lecture seule
Qualificateurs : Schéma (« Win32 »)

Win32 Configuration Manager code d’erreur.

Cette propriété est héritée de CIM_LogicalDevice.

Cet appareil fonctionne correctement. (0)

Cet appareil n’est pas configuré correctement. (1)

Windows ne peut pas charger le pilote pour cet appareil. (2)

Le pilote de cet appareil peut être endommagé ou votre système peut manquer de mémoire ou d’autres ressources. (3)

Cet appareil ne fonctionne pas correctement. L’un de ses pilotes ou votre registre peut être endommagé. (4)

Le pilote de cet appareil a besoin d’une ressource que Windows ne peut pas gérer. (5)

La configuration de démarrage de cet appareil est en conflit avec d’autres appareils. (6)

Impossible de filtrer. (7)

Le chargeur de pilote pour l’appareil est manquant. (8)

Cet appareil ne fonctionne pas correctement, car le microprogramme de contrôle signale les ressources de l’appareil de manière incorrecte. (9)

Cet appareil ne peut pas démarrer. (10)

Cet appareil a échoué. (11)

Cet appareil ne trouve pas suffisamment de ressources gratuites qu’il peut utiliser. (12)

Windows ne peut pas vérifier les ressources de cet appareil. (13)

Cet appareil ne peut pas fonctionner correctement tant que vous n’avez pas redémarré votre ordinateur. (14)

Cet appareil ne fonctionne pas correctement, car il existe probablement un problème de nouvelle énumération. (15)

Windows ne peut pas identifier toutes les ressources utilisées par cet appareil. (16)

Cet appareil demande un type de ressource inconnu. (17)

Réinstallez les pilotes pour ce périphérique. (18)

Échec de l’utilisation du chargeur VxD. (19)

Votre registre est peut-être endommagé. (20)

Défaillance du système : essayez de modifier le pilote pour cet appareil. Si cela ne fonctionne pas, consultez la documentation de votre matériel. Windows supprime cet appareil. (21)

Cet appareil est désactivé. (22)

Défaillance du système : essayez de modifier le pilote pour cet appareil. Si cela ne fonctionne pas, consultez la documentation de votre matériel. (23)

Cet appareil n’est pas présent, ne fonctionne pas correctement ou n’a pas tous ses pilotes installés. (24)

Windows est toujours en cours de configuration de cet appareil. (25)

Windows est toujours en cours de configuration de cet appareil. (26)

Cet appareil n’a pas de configuration de journal valide. (27)

Les pilotes de ce périphérique ne sont pas installés. (28)

Cet appareil est désactivé, car le microprogramme de l’appareil ne lui a pas donné les ressources nécessaires. (29)

Cet appareil utilise une ressource de demande d’interruption (IRQ) qu’un autre appareil utilise. (30)

Cet appareil ne fonctionne pas correctement, car Windows ne peut pas charger les pilotes requis pour cet appareil. (31)

ConfigManagerUserConfig

Type de données : booléen
Type d'accès : Lecture seule
Qualificateurs : Schéma (« Win32 »)

Si la valeur est TRUE, l’appareil utilise une configuration définie par l’utilisateur.

Cette propriété est héritée de CIM_LogicalDevice.

CreationClassName

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : CIM_Key

Nom de la classe ou de la sous-classe utilisée dans la création d’un instance. Lorsqu’elle est utilisée avec d’autres propriétés de clé de la classe, cette propriété permet à toutes les instances de la classe et à ses sous-classes d’être identifiées de manière unique.

Cette propriété est héritée de CIM_LogicalDevice.

Description

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : DisplayName (« Description »)

Description textuelle de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

DeviceID

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : CIM_Key

Adresse ou autres informations d’identification pour nommer de manière unique l’appareil logique.

Cette propriété est héritée de CIM_LogicalDevice.

ErrorCleared

Type de données : booléen
Type d'accès : Lecture seule

Si la valeur est TRUE, l’erreur signalée dans la propriété LastErrorCode est maintenant effacée.

Cette propriété est héritée de CIM_LogicalDevice.

ErrorDescription

Type de données : chaîne
Type d'accès : Lecture seule

Chaîne de forme libre qui fournit des informations sur l’erreur enregistrée dans la propriété LastErrorCode et les actions correctives à effectuer.

Cette propriété est héritée de CIM_LogicalDevice.

InstallDate

Type de données : datetime
Type d'accès : Lecture seule
Qualificateurs : MappingStrings (« MIF. DMTF| ComponentID|001.5 »), DisplayName (« Date d’installation »)

Indique quand l’objet a été installé. L’absence d’une valeur n’indique pas que l’objet n’est pas installé.

Cette propriété est héritée de CIM_ManagedSystemElement.

LastErrorCode

Type de données : uint32
Type d'accès : Lecture seule

Dernier code d’erreur signalé par l’appareil logique.

Cette propriété est héritée de CIM_LogicalDevice.

MaxNumberControl

Type de données : uint32
Type d'accès : Lecture seule
Qualificateurs : MappingStrings (« MIF. DMTF| Port bus|001.9 »)

Nombre maximal d’entités directement adressables prises en charge par ce contrôleur. La valeur 0 doit être utilisée si le nombre est inconnu ou illimité.

Nom

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : DisplayName (« Name »)

Étiquette par laquelle l’objet est connu. En cas de sous-classe, cette propriété peut être remplacée pour être une propriété de clé.

Cette propriété est héritée de CIM_ManagedSystemElement.

PNPDeviceID

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : Schéma (« Win32 »)

Indique l’identificateur d’appareil Win32 Plug-and-Play de l’appareil logique.

Exemple : « *PNP030b »

Cette propriété est héritée de CIM_LogicalDevice.

PowerManagementCapabilities

Type de données : uint16 array
Type d'accès : Lecture seule

Indique les fonctionnalités spécifiques liées à l’alimentation de l’appareil logique.

Cette propriété est héritée de CIM_LogicalDevice.

Inconnu (0)

Les capacités liées à l’alimentation sont inconnues.

Non pris en charge (1)

Les capacités liées à l’alimentation ne sont pas prises en charge pour cet appareil.

Désactivé (2)

Les capacités liées à l’alimentation ont été désactivées.

Activé (3)

Les fonctionnalités de gestion de l’alimentation sont actuellement activées, mais l’ensemble de fonctionnalités exact est inconnu ou les informations ne sont pas disponibles.

Modes d’économie d’énergie entrés automatiquement (4)

L’appareil peut modifier son état d’alimentation en fonction de l’utilisation ou d’autres critères.

Power State Settable (5)

La méthode SetPowerState est prise en charge. Cette méthode se trouve dans la classe parente CIM_LogicalDevice et peut être implémentée. Pour plus d’informations, consultez Conception de classes MOF (Managed Object Format).

Prise en charge du cycle d’alimentation (6)

La méthode SetPowerState peut être appelée avec le paramètre PowerState défini sur 5 (« Cycle d’alimentation »).

Prise en charge de l’alimentation chrono timed ( 7)

La méthode SetPowerState peut être appelée avec le paramètre PowerState défini sur 5 (« Cycle d’alimentation ») et le paramètre Time défini sur une date et une heure spécifiques, ou intervalle, pour la mise sous tension.

PowerManagementSupported

Type de données : booléen
Type d'accès : Lecture seule

Si la valeur est TRUE, l’appareil peut être géré sur l’alimentation, c’est-à-dire placé dans un état d’économie d’énergie. Si la valeur est FALSE, la valeur entière 1 (« Non pris en charge ») doit être la seule entrée du tableau PowerManagementCapabilities .

Cette propriété n’indique pas si les fonctionnalités de gestion de l’alimentation sont actuellement activées ou, si elles sont activées, quelles sont les fonctionnalités prises en charge. Pour plus d’informations, consultez le tableau PowerManagementCapabilities .

Cette propriété est héritée de CIM_LogicalDevice.

ProtocolSupported

Type de données : uint16
Type d'accès : Lecture seule
Qualificateurs : MappingStrings (« MIF. DMTF| Bus Port|001.2 », « MIF. DMTF| Disques|003.3 »)

Protocole utilisé par le contrôleur pour accéder aux appareils « contrôlés ».

Autre (1)

Inconnu (2)

EISA (3)

ISA (4)

PCI (5)

ATA/ATAPI (6)

Disquette flexible (7)

1496 (8)

Interface parallèle SCSI (9)

Protocole Fibre Channel SCSI (10)

Protocole de bus série SCSI (11)

SCSI Serial Bus Protocol-2 (1394) (12)

Architecture du stockage série SCSI (13)

VESA (14)

PCMCIA (15)

Bus série universel (16)

Protocole parallèle (17)

ESCON (18)

Diagnostic (19)

I2C (20)

Alimentation (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 Token-Ring (33)

ANSI X3T9.5 FDDI (34)

MCA (35)

ESDI (36)

IDE (37)

CMD (38)

ST506 (39)

DSSI (40)

QIC2 (41)

ATA/IDE amélioré (42)

AGP (43)

TWIRP (infrarouge bidirectionnel) (44)

FIR (infrarouge rapide) (45)

SIR (infrarouge série) (46)

IrBus (47)

État

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : MaxLen (10), DisplayName (« Status »)

Chaîne qui indique la status actuelle de l’objet. Il est possible de définir des status opérationnels et non opérationnels. Les status opérationnelles peuvent inclure « OK », « Détérioré » et « Échec anticipé ». « Échec anticipé » indique qu’un élément fonctionne correctement, mais qu’il prédit une défaillance (par exemple, un disque dur smart).

Les status non opérationnelles peuvent inclure « Error », « Starting », « Stopping » et « Service ». « Service » peut s’appliquer pendant la miroir disque, le rechargement d’une liste d’autorisations utilisateur ou tout autre travail administratif. Tous ces travaux ne sont pas en ligne, mais l’élément managé n’est ni « OK » ni dans l’un des autres états.

Cette propriété est héritée de CIM_ManagedSystemElement.

Les valeurs sont notamment les suivantes :

OK (« OK »)

Erreur (« Erreur »)

Dégradé (« Dégradé »)

Inconnu (« Inconnu »)

Échec du prédé (« Échec anticipé »)

Démarrage (« Démarrage »)

Arrêt (« Arrêt »)

Service (« Service »)

Stressé (« Stressé »)

NonRecover (« NonRecover »)

Aucun contact (« Aucun contact »)

Lost Comm (« Lost Comm »)

StatusInfo

Type de données : uint16
Type d'accès : Lecture seule
Qualificateurs : MappingStrings (« MIF. DMTF| État opérationnel|003.3 »)

État de l’appareil logique. Si cette propriété ne s’applique pas à l’appareil logique, la valeur 5 (« Non applicable ») doit être utilisée.

Cette propriété est héritée de CIM_LogicalDevice.

Autre (1)

Inconnu (2)

Activé (3)

Désactivé (4)

Non applicable (5)

SystemCreationClassName

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : propagé (« CIM_System. CreationClassName »), CIM_Key

Nom de la classe de création du système d’étendue.

Cette propriété est héritée de CIM_LogicalDevice.

SystemName

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : propagé (« CIM_System. Nom « ), CIM_Key

Nom du système d’étendue.

Cette propriété est héritée de CIM_LogicalDevice.

TimeOfLastReset

Type de données : datetime
Type d'accès : Lecture seule

Date et heure de la dernière réinitialisation du contrôleur (mise hors tension ou réinitialisation).

Notes

La classe CIM_Controller est dérivée de CIM_LogicalDevice.

WMI n’implémente pas cette classe. Pour les classes dérivées de CIM_Controller, consultez Classes Win32.

Cette documentation est dérivée des descriptions de classes CIM publiées par le DMTF. Microsoft a peut-être apporté des modifications pour corriger des erreurs mineures, se conformer aux normes de documentation du Kit de développement logiciel (SDK) Microsoft ou fournir des informations supplémentaires.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Espace de noms	Racine\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Voir aussi

CIM_LogicalDevice

Partager via

classe CIM_Controller (fournisseurs WMI CIMWin32)

Syntaxe

Membres

Méthodes

Propriétés

Notes

Spécifications

Voir aussi

Commentaires

Ressources supplémentaires