CIM_MediaAccessDevice, classe (fournisseurs WMI CIMWin32)
La classe CIM _ MediaAccessDevice représente la possibilité d’accéder à un ou plusieurs médias, puis d’utiliser le média pour stocker et récupérer des données.
Important
Les classes de la DMTF (Distributed Management Task Force) CIM (Common Information Model) sont les classes parentes sur lesquelles les classes WMI sont générées. WMI ne prend actuellement en charge que 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 par ordre alphabétique, et non par ordre MOF.
Syntaxe
[Abstract, UUID("{8502C52A-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_MediaAccessDevice : 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;
uint16 Capabilities[];
string CapabilityDescriptions[];
string CompressionMethod;
uint64 DefaultBlockSize;
string ErrorMethodology;
uint64 MaxBlockSize;
uint64 MaxMediaSize;
uint64 MinBlockSize;
boolean NeedsCleaning;
uint32 NumberOfMediaSupported;
};
Membres
La classe CIM _ MediaAccessDevice possède les types de membres suivants :
Méthodes
La classe CIM _ MediaAccessDevice possède ces méthodes.
| Méthode | Description |
|---|---|
| Réinitialiser | Demande la réinitialisation de l’unité logique. Non implémenté par WMI. |
| SetPowerState | Définit l’état d’alimentation souhaité pour un périphérique logique et lorsqu’un appareil doit être placé dans cet État. Non implémenté par WMI. |
Propriétés
La classe CIM _ MediaAccessDevice possède les propriétés suivantes.
-
Disponibilité
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings ("MIF. |État opérationnel DMTF | 003,5 "," MIB. |Hôte IETF-ressources-MIB. hrDeviceStatus ")
Disponibilité et état 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étérioré (10)
-
Non installé (11)
-
Erreur d’installation (12)
-
Économie d’énergie-inconnu (13)
-
L’appareil est connu pour être en mode d’économie d’énergie, mais son état exact est inconnu.
-
Économie d’énergie-mode faible puissance (14)
-
L’appareil est dans un état d’économie d’énergie, mais fonctionne toujours et peut présenter des performances dégradées.
-
Économie d’énergie-veille (15)
-
L’appareil ne fonctionne pas mais peut être mis à la pleine puissance rapidement.
-
Cycle d’alimentation (16)
-
Économie d’énergie-Avertissement (17)
-
L’appareil est dans un état d’avertissement, bien qu’il soit également en mode d’économie d’énergie.
-
En Pause (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é.
-
Suspendu (21)
-
L’appareil est calme.
Capabilities
-
Type de données : tableau UInt16
-
Type d'accès : Lecture seule
-
Qualificateurs : arrayType ("Indexed"), MappingStrings ("MIF. |appareils de Stockage DMTF | 001,9 "," MIF. |appareils de Stockage DMTF | 001,11 "," MIF. |appareils de Stockage DMTF | 001,12 "," MIF. |Disques DMTF | 003,7 "), ModelCorrespondence ("CIM _ MediaAccessDevice.CapabilityDescriptions")
Fonctionnalités de l’appareil d’accès aux médias.
Inconnu (0)
Inconnu.
Autre (1)
Autre.
Accès séquentiel (2)
Accès séquentiel.
Accès aléatoire (3)
Accès aléatoire.
Prend en charge l’écriture (4)
Écriture.
Chiffrement (5)
Chiffrement.
Compression (6)
Compression.
Prend en charge les supports amovibles (7)
Support amovible.
Nettoyage manuel (8)
Nettoyage manuel.
Nettoyage automatique (9)
Nettoyage automatique.
Notification intelligente (10)
Notification intelligente.
Prend en charge les supports à double face (11)
Média double face.
Distingue un appareil qui peut accéder aux deux côtés d’un média à deux faces à partir d’un appareil qui ne lit qu’un seul côté et requiert le basculement du média.
Predismount EJECT non requis (12)
Indique qu’il n’est pas nécessaire d’éjecter explicitement le média de l’appareil avant d’y accéder par un élément sélecteur.
CapabilityDescriptions
-
Type de données : tableau de chaînes
-
Type d'accès : Lecture seule
-
Qualificateurs : arrayType ("Indexed"), ModelCorrespondence ("CIM _ MediaAccessDevice.Capacités»)
Tableau de chaînes de forme libre qui fournit des explications détaillées pour l’accès aux fonctionnalités d’appareil indiquées dans le tableau de fonctionnalités .
Notes
Chaque entrée de ce tableau est liée à l’entrée dans le tableau des fonctionnalités , située dans le même index.
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.
CompressionMethod
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Chaîne de forme libre qui indique l’algorithme ou l’outil utilisé pour compresser le fichier logique. S’il n’est pas possible de décrire le schéma de compression (car il est inconnu), utilisez ce qui suit : if, use « Unknown ». Si, utilisez « Compressed ». , utilisez « non compressé ».
Connue
Le schéma de compression est inconnu ou non décrit.
Compact
Le fichier logique est compressé, mais le schéma de compression est inconnu ou n’est pas décrit.
« Non compressé »
Si le fichier logique n’est pas compressé
ConfigManagerErrorCode
-
Type de données : UInt32
-
Type d'accès : Lecture seule
-
Qualificateurs : Schema ("Win32")
Code d’erreur Configuration Manager Win32.
Cette propriété est héritée de CIM _ LogicalDevice.
Ce périphérique fonctionne correctement. (0)
Ce périphérique n’est pas configuré correctement. (1)
Windows ne peut pas charger le pilote de cet appareil. (2)
Le pilote de cet appareil est peut-être endommagé ou votre système ne dispose peut-être pas de suffisamment de mémoire ou d’autres ressources. (3)
Cet appareil ne fonctionne pas correctement. L’un de ses pilotes ou votre registre est peut-être endommagé. (4)
le pilote de cet appareil a besoin d’une ressource qui ne peut pas être gérée par Windows. (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 de l’appareil est manquant. (8)
Ce périphérique ne fonctionne pas correctement, car le microprogramme de contrôle ne signale pas correctement les ressources pour l’appareil. (9)
Impossible de démarrer cet appareil. (10)
Échec de cet appareil. (11)
Ce périphérique ne peut pas trouver suffisamment de ressources disponibles. douze
Windows ne pouvez pas vérifier les ressources de ce périphérique. (13)
Ce périphérique ne peut pas fonctionner correctement tant que vous n’avez pas redémarré votre ordinateur. (14)
Cet appareil ne fonctionne pas correctement en raison d’un problème de réénumération. (15)
Windows ne peut pas identifier toutes les ressources utilisées par cet appareil. (16)
Ce périphérique demande un type de ressource inconnu. (17)
Réinstallez les pilotes pour cet appareil. (18)
Échec lors de l’utilisation du chargeur VxD. (19)
Votre registre est peut-être endommagé. (20)
Défaillance du système : essayez de modifier le pilote de 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 de cet appareil. Si cela ne fonctionne pas, consultez la documentation de votre matériel. (23)
Ce périphérique n’est pas présent, ne fonctionne pas correctement ou tous ses pilotes ne sont pas installés. (24)
Windows est toujours en cours d’installation sur cet appareil. (25)
Windows est toujours en cours d’installation sur cet appareil. (26)
Cet appareil n’a pas de configuration de journal valide. (27)
Les pilotes de cet appareil ne sont pas installés. (28)
Ce périphérique est désactivé, car le microprogramme de l’appareil ne lui a pas donné les ressources requises. (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 : Schema ("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 : _ clé CIM
Nom de la classe ou de la sous-classe utilisée dans la création d’une instance. Lorsqu’elle est utilisée avec d’autres propriétés de clé de la classe, cette propriété autorise l’identification unique de toutes les instances de la classe et de ses sous-classes.
Cette propriété est héritée de CIM _ LogicalDevice.
DefaultBlockSize
-
Type de données : UInt64
-
Type d'accès : Lecture seule
-
Qualificateurs : Units ("bytes")
Taille de bloc par défaut, en octets, pour l’appareil.
Pour plus d’informations sur l’utilisation des valeurs UInt64 dans les scripts, consultez scripts dans WMI.
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 : _ clé CIM
Adresse ou d’autres informations d’identification pour nommer de manière unique l’unité 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 désactivé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.
ErrorMethodology
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Chaîne de forme libre qui décrit les types de détection d’erreurs et de correction pris en charge par l’appareil.
InstallDate
-
Type de données : DateTime
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings ("MIF. DMTF | ComponentID | 001,5 "), DisplayName (" date d’installation ")
Indique le moment où l’objet a été installé. L’absence de 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’unité logique.
Cette propriété est héritée de CIM _ LogicalDevice.
MaxBlockSize
-
Type de données : UInt64
-
Type d'accès : Lecture seule
-
Qualificateurs : Units ("bytes")
Taille maximale de bloc, en octets, pour les médias accessibles par l’appareil.
Pour plus d’informations sur l’utilisation des valeurs UInt64 dans les scripts, consultez scripts dans WMI.
MaxMediaSize
-
Type de données : UInt64
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings ("MIF. |Appareils d’accès séquentiel DMTF | 001,2 "), unités (" kilo-octets ")
Taille maximale, en kilo-octets, des médias pris en charge par cet appareil. Les kilo-octets sont interprétés comme le nombre d’octets multiplié par 1000 (pas le nombre d’octets multiplié par 1024).
Pour plus d’informations sur l’utilisation des valeurs UInt64 dans les scripts, consultez scripts dans WMI.
MinBlockSize
-
Type de données : UInt64
-
Type d'accès : Lecture seule
-
Qualificateurs : Units ("bytes")
Taille de bloc minimale, en octets, pour les médias accessibles par l’appareil.
Pour plus d’informations sur l’utilisation des valeurs UInt64 dans les scripts, consultez scripts dans WMI.
Nom
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : DisplayName ("Name")
Étiquette par laquelle l’objet est connu. Lorsqu’elle est sous-classée, cette propriété peut être substituée pour être une propriété de clé.
Cette propriété est héritée de CIM _ ManagedSystemElement.
NeedsCleaning
-
Type de données : booléen
-
Type d'accès : Lecture seule
Si la valeur est true, l’appareil d’accès aux médias doit être nettoyé. La possibilité de procéder à un nettoyage manuel ou automatique est indiquée dans la propriété du tableau Capabilities .
NumberOfMediaSupported
-
Type de données : UInt32
-
Type d'accès : Lecture seule
Nombre maximal de plusieurs supports individuels qui peuvent être pris en charge ou insérés.
PNPDeviceID
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : Schema ("Win32")
Indique l’identificateur d’appareil Plug-and-Play Win32 de l’appareil logique.
Exemple : « * PNP030b »
Cette propriété est héritée de CIM _ LogicalDevice.
PowerManagementCapabilities
-
Type de données : tableau UInt16
-
Type d'accès : Lecture seule
Indique les fonctionnalités de gestion de l’alimentation spécifiques de l’appareil logique.
Cette propriété est héritée de CIM _ LogicalDevice.
Inconnu (0)
Les capacités associé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 associées à l’alimentation ont été désactivées.
Activé (3)
Les fonctionnalités de gestion de l’alimentation sont actuellement activées, mais le jeu 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.
État d’alimentation définissable (5)
La méthode SetPowerState est prise en charge. Cette méthode se trouve sur la classe parente du _ LogicalDevice CIM et peut être implémentée. Pour plus d’informations, consultez conception de Classes format MOF (MOF).
Cycle d’alimentation pris en charge (6)
La méthode SetPowerState peut être appelée avec le paramètre PowerState défini sur 5 (« Power cycle »).
Mise sous tension minutée prise en charge (7)
La méthode SetPowerState peut être appelée avec le paramètre PowerState défini sur 5 (« Power cycle ») et le paramètre Time défini sur une date et une heure spécifiques, ou un 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é par le biais de l’alimentation, c’est-à-dire être mis en é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 dans le 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.
État
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (10), DisplayName ("Status")
Chaîne qui indique l’état actuel de l’objet. L’état opérationnel et non opérationnel peut être défini. L’état opérationnel peut inclure « OK », « détérioré » et « échec prédit ». « Échec prédit » indique qu’un élément fonctionne correctement, mais prédit un échec (par exemple, un lecteur de disque dur intelligent).
L’état non opérationnel peut inclure « erreur », « démarrage », « arrêt » et « service ». Le « service » peut s’appliquer pendant la mise en miroir de disques, en rechargeant une liste d’autorisations utilisateur ou d’autres tâches administratives. Tous les travaux de ce type ne sont pas en ligne, mais l’élément géré n’est ni « OK », ni 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étérioré (« détérioré »)
Inconnu ("inconnu")
Échec prévu (« échec prédit »)
Démarrage en cours (« démarrage »)
Arrêt en cours (« arrêt »)
Service (« service »)
Stressed (« stressed »)
Non récupéré (« non récupéré »)
Aucun contact (« aucun contact »)
Communication perdue (« inversée comm »)
StatusInfo
-
Type de données : UInt16
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings ("MIF. |État opérationnel DMTF | 003,3 ")
État de l’unité logique. Si cette propriété ne s’applique pas à l’unité 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 : Propaged ("CIM _ System.CreationClassName"), _ clé CIM
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 : Propaged ("CIM _ System.Name"), _ clé CIM
Nom du système d’étendue.
Cette propriété est héritée de CIM _ LogicalDevice.
Notes
La classe CIM _ MediaAccessDevice est dérivée de CIM _ LogicalDevice.
WMI n’implémente pas cette classe. Pour les classes dérivées de CIM _ MediaAccessDevice, consultez classes Win32.
Cette documentation est dérivée des descriptions de classe CIM publiées par le DMTF. Microsoft peut avoir apporté des modifications pour corriger les erreurs mineures, se conformer aux normes de documentation du kit de développement logiciel (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 |
\Cimv2 racine |
| MOF |
|
| DLL |
|