commande open

Article
06/13/2023

La commande open initialise un appareil. 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("open %s %s %s"), 
  lpszDevice, 
  lpszOpenFlags, 
  lpszFlags
);

Paramètres

lpszDevice

Identificateur d’un périphérique ou d’un pilote de périphérique MCI. Il peut s’agir d’un nom d’appareil (tel qu’indiqué dans le registre ou le fichier SYSTEM.INI) ou du nom de fichier du pilote de périphérique. Si vous spécifiez le nom de fichier du pilote de périphérique, vous pouvez éventuellement inclure . Extension DRV, mais vous ne devez pas inclure le chemin d’accès au fichier.

lpszOpenFlags

Indicateur qui identifie les éléments à initialiser. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande open et les indicateurs utilisés par chaque type.

Valeur	Signification	Signification
cdaudio	alias device_aliaspartageable	type device_type
digitalvideo	alias device_aliaselementnameparent nostatic hwndsharable	style enfant style de style superposé style style_typetype device_type
superposition	alias device_aliasenfant de style partageable hwndparent	style de style superposé style style_typetype device_type
sequencer	alias device_alias partageable	type device_type
Magnétoscope	alias device_aliaspartageable	type device_type
videodisk	alias device_aliaspartageable	type device_type
waveaudio	alias device_aliastampon buffer_size	device_type de type partageable

Le tableau suivant répertorie les indicateurs qui peuvent être spécifiés dans le paramètre lpszOpenFlags et leurs significations.

Valeur	Signification
alias device_alias	Spécifie un autre nom pour l’appareil donné. S’il est spécifié, il doit être utilisé comme device_id dans les commandes suivantes.
Elementname	Spécifie le nom de l’élément d’appareil (fichier) chargé à l’ouverture de l’appareil.
buffer_size de mémoire tampon	Définit la taille, en secondes, de la mémoire tampon utilisée par l’appareil waveform-audio. La taille par défaut de la mémoire tampon est définie lorsque l’appareil waveform-audio est installé ou configuré. En général, la taille de la mémoire tampon est définie sur 4 secondes. Avec l’appareil MCIWAVE, la taille minimale est de 2 secondes et la taille maximale est de 9 secondes.
parent hwnd	Spécifie le handle de fenêtre de la fenêtre parente.
Partageable	Initialise l’appareil ou le fichier comme pouvant être partagé. Les tentatives suivantes d’ouverture de l’appareil ou du fichier échouent, sauf si vous spécifiez « partageable » dans les commandes d’ouverture d’origine et suivantes. MCI retourne une erreur d’appareil non valide si l’appareil est déjà ouvert et ne peut pas être partagé. Le séquenceur MCISEQ et les appareils MCIWAVE ne prennent pas en charge les fichiers partagés.
style enfant	Ouvre une fenêtre avec un style de fenêtre enfant.
style superposé	Ouvre une fenêtre avec un style de fenêtre superposé.
fenêtre contextuelle de style	Ouvre une fenêtre avec un style de fenêtre contextuelle.
style style_type	Indique un style de fenêtre.
type device_type	Spécifie le type d’appareil d’un fichier.

lpszFlags

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

Valeur renvoyée

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

Notes

MCI réserve « cdaudio » pour le type d’appareil audio CD, « videodisc » pour le type d’appareil videodisc, « sequencer » pour le type d’appareil séquenceur MIDI, « AVIVideo » pour le type d’appareil vidéo numérique et « waveaudio » pour le type d’appareil waveform-audio.

En guise d’alternative à l’indicateur « type », MCI peut sélectionner l’appareil en fonction de l’extension utilisée par le fichier, tel qu’enregistré dans le Registre ou la section [extension mci] du fichier SYSTEM.INI.

MCI peut ouvrir des fichiers AVI à l’aide d’un pointeur d’interface de fichier ou d’un pointeur d’interface de flux. Pour ouvrir un fichier à l’aide de l’un ou l’autre type de pointeur d’interface, spécifiez un signe at (@) suivi du pointeur d’interface à la place du fichier ou du nom de périphérique pour le paramètre lpszDevice . Pour plus d’informations sur les interfaces de fichiers et de flux, consultez « Fonctions et macros AVIFile ».

La commande suivante ouvre l’appareil « mysound ».

open new type waveaudio alias mysound buffer 6

Avec le nom de l’appareil « new », le pilote de forme d’onde prépare une nouvelle ressource de forme d’onde. La commande affecte l’alias de l’appareil « mysound » et spécifie une mémoire tampon de 6 secondes.

Vous pouvez éliminer l’indicateur « type » si vous combinez le nom de l’appareil avec le nom de fichier. MCI reconnaît cette combinaison lorsque vous utilisez la syntaxe suivante :

device_name ! element_name

Le point d’exclamation sépare le nom de l’appareil du nom de fichier. Le point d’exclamation ne doit pas être délimité par des espaces blancs.

L’exemple suivant ouvre la droite. Fichier WAV utilisant l’appareil « waveaudio ».

open waveaudio!right.wav

Le pilote MCIWAVE nécessite un périphérique audio de forme d’onde asynchrone.

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

Partager via