classe CIM_PointingDevice (fournisseurs WMI CIMWin32)

Article
06/13/2023

La classe CIM_PointingDevice représente un appareil qui pointe vers des régions à l’écran. Tout appareil qui manipule un pointeur ou pointe vers des régions sur un affichage visuel est membre de cette classe. Par exemple, une souris, un stylet, un pavé tactile ou une tablette.

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 uniquement en charge les schémas de version CIM 2.x.

La syntaxe suivante est simplifiée à partir du code MOF (Managed Object Format) et inclut toutes ses 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("{8502C535-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_PointingDevice : CIM_UserDevice
{
  uint16   Availability;
  string   Caption;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  uint16   Handedness;
  datetime InstallDate;
  boolean  IsLocked;
  uint32   LastErrorCode;
  string   Name;
  uint8    NumberOfButtons;
  string   PNPDeviceID;
  uint16   PointingType;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  uint32   Resolution;
  string   Status;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
};

Membres

La classe CIM_PointingDevice comporte les types de membres suivants :

Méthodes
Propriétés

Méthodes

La classe CIM_PointingDevice a 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_PointingDevice a ces propriétés.

Disponibilité

Type de données : uint16
Type d'accès : Lecture seule
Qualificateurs : MappingStrings (« MIF. DMTF| Operational State|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 alimentation (3)

Avertissement (4)

En test (5)

Non applicable (6)

Mise hors tension (7)

Hors ligne (8)

Hors service (9)

Détérioré (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 toujours en fonctionnement, et peut présenter des performances dégradées.

Économie d’alimentation - Veille (15)

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

Cycle d’alimentation (16)

Power Save - Avertissement (17)

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

Suspendu (18)

L’appareil est suspendu.

Pas 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 »)

Code d’erreur win32 Configuration Manager.

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

Cet appareil fonctionne correctement. (0)

L’appareil fonctionne correctement.

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

L’appareil n’est pas configuré correctement.

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

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

Le pilote de cet appareil peut être endommagé, ou le système peut être faible en mémoire ou d’autres ressources.

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

L’appareil ne fonctionne pas correctement. L’un de ses pilotes ou le registre peut être endommagé.

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

Le pilote de l’appareil nécessite une ressource que Windows ne peut pas gérer.

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

La configuration de démarrage de l’appareil est en conflit avec d’autres appareils.

Impossible de filtrer. (7)

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

Le chargeur de pilotes pour l’appareil est manquant.

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

L’appareil ne fonctionne pas correctement. Le microprogramme de contrôle signale de manière incorrecte les ressources de l’appareil.

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

L’appareil ne peut pas démarrer.

Cet appareil a échoué. (11)

Échec de l’appareil.

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

L’appareil ne trouve pas suffisamment de ressources gratuites à utiliser.

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

Windows ne peut pas vérifier les ressources de l’appareil.

Cet appareil ne peut pas fonctionner correctement tant que vous ne redémarrez pas votre ordinateur. (14)

L’appareil ne peut pas fonctionner correctement tant que l’ordinateur n’est pas redémarré.

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

L’appareil ne fonctionne pas correctement en raison d’un problème de réinsentération possible.

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

Windows ne peut pas identifier toutes les ressources utilisées par l’appareil.

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

L’appareil demande un type de ressource inconnu.

Réinstallez les pilotes de cet appareil. (18)

Les pilotes de périphérique doivent être réinstallés.

Échec à l’aide du chargeur VxD. (19)

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

Le Registre peut être endommagé.

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)

Défaillance du système. Si la modification du pilote de périphérique n’est pas efficace, consultez la documentation matérielle. Windows supprime l’appareil.

Cet appareil est désactivé. (22)

L’appareil est désactivé.

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

Défaillance du système. Si la modification du pilote de périphérique n’est pas efficace, consultez la documentation matérielle.

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

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

Windows configure toujours cet appareil. (25)

Windows configure toujours l’appareil.

Windows configure toujours cet appareil. (26)

Windows configure toujours l’appareil.

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

L’appareil n’a pas de configuration de journal valide.

Les pilotes de cet appareil ne sont pas installés. (28)

Les pilotes de périphérique ne sont pas installés.

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

L’appareil est désactivé. Le microprogramme de l’appareil ne fournissait pas les ressources requises.

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

L’appareil utilise une ressource IRQ qu’un autre appareil utilise.

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

L’appareil ne fonctionne pas correctement. Windows ne peut pas charger les pilotes de périphérique requis.

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 clés de la classe, cette propriété permet à toutes les instances de la classe et de 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 permettant de 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.

La main

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

Configuration de l’appareil de pointage pour une opération à droite ou à gauche.

Inconnu (0)

Non applicable (1)

Opération droitier (2)

Opération à droite

Opération gaucher (3)

Opération de gauche

InstallDate

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

Date et heure d’installation de l’objet. Cette propriété n’a pas besoin d’une valeur pour indiquer que l’objet est installé.

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

IsLocked

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

Si la valeur est TRUE, l’appareil est verrouillé, ce qui empêche l’entrée ou la sortie de l’utilisateur.

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

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.

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.

NumberOfButtons

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

Nombre de boutons sur l’appareil pointant.

Exemple : « 2 »

PNPDeviceID

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

Win32 Plug-and-Play identificateur d’appareil de l’appareil logique. Cette propriété est héritée de CIM_LogicalDevice.

Exemple : « *PNP030b »

PointingType

Type de données : uint16
Type d'accès : Lecture seule
Qualificateurs : MappingStrings (« MIF. DMTF| Appareil pointant|001.1 »)

Type de l’appareil pointant.

Autre (1)

Inconnu (2)

Souris (3)

Track Ball (4)

Trackball

Point de suivi (5)

Point de glissement (6)

Pavé tactile (7)

Écran tactile (8)

Souris - Capteur optique (9)

Capteur optique de souris

PowerManagementCapabilities

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

Tableau des fonctionnalités spécifiques liées à l’alimentation d’un appareil logique.

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

Inconnu (0)

Non pris en charge (1)

Désactivé (2)

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 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.

Résolution :

Type de données : uint32
Type d'accès : Lecture seule
Qualificateurs : unités (« nombres par pouce »)

Résolution du suivi.

Exemple : « 0 »

État

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

Status actuelle de l’objet. 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

Étendue du nom de la classe de création du système.

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.

Notes

La classe CIM_PointingDevice est dérivée de CIM_UserDevice.

WMI n’implémente pas cette classe. Pour les classes WMI dérivées de CIM_PointingDevice, 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 SDK Microsoft ou fournir plus d’informations.

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_UserDevice

Partager via

classe CIM_PointingDevice (fournisseurs WMI CIMWin32)

Syntaxe

Membres

Méthodes

Propriétés

Notes

Spécifications

Voir aussi

Commentaires

Ressources supplémentaires