commande open
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 |
|