commande close

La commande close ferme l’appareil ou le fichier et toutes les ressources associées. MCI décharge un appareil lorsque toutes les instances de l’appareil ou tous les fichiers sont fermés. Tous les appareils MCI reconnaissent cette commande.

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

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

Paramètres

lpszDeviceID

Identificateur d’un appareil MCI. Cet identificateur ou alias est attribué lorsque l’appareil est ouvert.

lpszFlags

Peut être « attendre », « notifier » ou les deux. Pour plus d’informations sur ces indicateurs, consultez Les indicateurs d’attente, de notification et de test.

Valeur renvoyée

Retourne zéro en cas de réussite ou d’erreur dans le cas contraire.

Notes

Pour fermer tous les appareils ouverts par votre application, spécifiez l’identificateur « all » pour le paramètre lpszDeviceID .

La fermeture de l’appareil cdaudio arrête la lecture audio.

Windows 2000/XP : Si l’appareil cdaudio est en cours de lecture, la fermeture de l’appareil cdaudio n’entraîne pas l’arrêt de la lecture de l’audio. Envoyez d’abord la commande stop .

Exemples

La commande suivante ferme l’appareil « mysound ».

close mysound

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	Corecrt_io.h

Voir aussi

MCI

Chaînes de commande MCI