commande sysinfo

La commande sysinfo récupère les informations système MCI. La commande sysinfo est une commande système MCI ; il est interprété directement par MCI.

Pour envoyer cette commande, appelez la fonction mciSendString avec le paramètre lpszCommand défini comme suit.

_stprintf_s(
  lpszCommand, 
  TEXT("sysinfo %s %s %s"), 
  lpszDeviceID, 
  lpszRequest, 
  lpszFlags
);

Paramètres

lpszDeviceID

Identificateur d’un appareil MCI ou d’un type d’appareil. Si un type d’appareil est spécifié, il doit s’agir d’un nom de type d’appareil MCI standard, comme indiqué dans le matériel de référence pour la commande de capacité . Vous pouvez spécifier « all » lorsque l’indicateur spécifié dans lpszRequest autorise cette possibilité.

lpszRequest

L’un des indicateurs suivants.

Valeur	Signification
installname	Retourne le nom répertorié dans le Registre ou le fichier SYSTEM.INI utilisé pour installer l’appareil ouvert avec l’identificateur d’appareil spécifié.
quantity	Retourne le nombre d’appareils MCI répertoriés dans le Registre ou le fichier SYSTEM.INI du type spécifié dans le paramètre lpszDeviceID . Cet identificateur d’appareil doit être un nom de type d’appareil MCI standard. Tous les chiffres après le type d’appareil sont ignorés. La spécification de « all » pour lpszDeviceID retourne le nombre total d’appareils MCI dans le système.
quantité ouverte	Retourne le nombre d’appareils MCI ouverts du type spécifié dans lpszDeviceID. Cet identificateur d’appareil doit être un nom de type d’appareil MCI standard. La spécification de « all » pour lpszDeviceID renvoie le nombre total d’appareils MCI ouverts dans le système.
index de nom	Retourne le nom d’un appareil MCI. L’identificateur de l’appareil doit être un nom de type d’appareil MCI standard. L’index varie de 1 au nombre d’appareils de ce type. Si « all » est spécifié pour lpszDeviceID, l’index varie de 1 au nombre total d’appareils dans le système.
index de nom ouvert	Retourne le nom d’un appareil MCI ouvert. L’identificateur de l’appareil doit être un nom de type d’appareil MCI standard. L’index varie de 1 au nombre d’appareils ouverts de ce type d’appareil. Si « all » est spécifié pour lpszDeviceID, l’index varie de 1 au nombre total d’appareils ouverts dans le système.

lpszFlags

Peut être « attendre », « notifier » ou les deux. Pour les appareils de vidéo numérique et de magnétoscope, « test » peut également être spécifié. Pour plus d’informations sur ces indicateurs, consultez Les indicateurs d’attente, de notification et de test.

Exemples

La commande suivante retourne le nombre d’appareils audio de forme d’onde ouverts.

sysinfo waveaudio quantity open

La commande suivante retourne le nom (alias d’appareil) du premier appareil audio de forme d’onde ouvert.

sysinfo waveaudio name 1 open

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]

Voir aussi

MCI

Chaînes de commande MCI

Capacité