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	Mmsystem.h (inclure Windows.h)

Voir aussi

MCI

Commandes MCI