_Commande MCI sysinfo
La _ commande MCI sysinfo récupère des informations sur les périphériques MCI. MCI prend en charge cette commande directement au lieu de la transmettre à l’appareil. Toute application MCI peut utiliser cette commande. Les informations de chaîne sont retournées dans la mémoire tampon fournie par l’application vers laquelle pointe le membre lpstrReturn de la structure identifiée par lpSysInfo. Les informations numériques sont retournées sous la forme d’une valeur DWORD placée dans la mémoire tampon fournie par l’application. Le membre dwRetSize spécifie la longueur de la mémoire tampon.
Pour envoyer cette commande, appelez la fonction mciSendCommand avec les paramètres suivants.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_SYSINFO,
DWORD dwFlags,
(DWORD) (LPMCI_SYSINFO_PARMS) lpSysInfo
);
Paramètres
-
wDeviceID
-
Identificateur de l’appareil MCI qui doit recevoir le message de commande.
-
dwFlags
-
Un ou plusieurs des indicateurs standard et spécifiques à la commande suivants :
-
_INSTALLNAME MCI sysinfo _
-
Obtient le nom (indiqué dans le registre ou le fichier SYSTEM.INI) utilisé pour installer l’appareil.
-
_nom MCI sysinfo _
-
Obtient un nom de périphérique correspondant au numéro d’appareil spécifié dans le membre dwNumber de la structure identifiée par lpSysInfo. Si l' _ _ indicateur d’ouverture MCI sysinfo est défini, MCI retourne les noms des appareils ouverts.
-
MCI _ sysinfo _ ouvert
-
Obtient la quantité ou le nom des appareils ouverts.
-
_quantité MCI sysinfo _
-
Obtient le nombre d’appareils du type spécifié qui sont répertoriés dans le registre ou la [ section MCI ] du fichier SYSTEM.INI. Si l' _ _ indicateur d’ouverture MCI sysinfo est défini, le nombre d’appareils ouverts est retourné.
-
lpSysInfo
-
Pointeur vers une structure de valeur MCI _ sysinfo _ .
Valeur renvoyée
Retourne zéro en cas de réussite ou une erreur.
Notes
Le membre wDeviceType de la structure identifiée par lpSysInfo est utilisé pour indiquer le type d’appareil de la requête. Si le paramètre wDeviceID est défini sur MCI _ All _ Device _ ID, il remplace la valeur de wDeviceType. Pour obtenir la liste des types d’appareils, consultez types d’appareils MCI.
Les valeurs de retour de type entier sont des valeurs DWORD retournées dans la mémoire tampon vers laquelle pointe le membre lpstrReturn de la structure identifiée par lpSysInfo.
Les valeurs de retour de chaîne sont des chaînes terminées par le caractère null retournées dans la mémoire tampon vers laquelle pointe le membre lpstrReturn de la structure identifiée par lpSysInfo.
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] |
| En-tête |
|