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

Voir aussi

MCI

Commandes MCI