commande MCI_SYSINFO
La commande MCI_SYSINFO récupère des informations sur les appareils 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 devant recevoir le message de commande.
-
dwFlags
-
Un ou plusieurs des indicateurs standard et spécifiques aux commandes suivants :
-
MCI_SYSINFO_INSTALLNAME
-
Obtient le nom (répertorié dans le registre ou le fichier SYSTEM.INI) utilisé pour installer l’appareil.
-
MCI_SYSINFO_NAME
-
Obtient un nom d’appareil correspondant au numéro d’appareil spécifié dans le membre dwNumber de la structure identifiée parlpSysInfo. Si l’indicateur MCI_SYSINFO_OPEN est défini, MCI retourne les noms des appareils ouverts.
-
MCI_SYSINFO_OPEN
-
Obtient la quantité ou le nom des appareils ouverts.
-
MCI_SYSINFO_QUANTITY
-
Obtient le nombre d’appareils du type spécifié répertoriés dans le Registre ou la section [mci] du fichier SYSTEM.INI. Si l’indicateur MCI_SYSINFO_OPEN est défini, le nombre d’appareils ouverts est retourné.
-
lpSysInfo
-
Pointeur vers une structure MCI_SYSINFO_PARMS .
Valeur renvoyée
Retourne zéro en cas de réussite ou une erreur dans le cas contraire.
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 d’entier sont des valeurs DWORD retournées dans la mémoire tampon pointée par le membre lpstrReturn de la structure identifiée par lpSysInfo.
Les valeurs de retour de chaîne sont des chaînes terminées par null retournées dans la mémoire tampon pointée par 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 |
|