ouvrir une commande

La commande Open Initialise un appareil. Tous les périphériques 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 MCI ou d’un pilote de périphérique. Il peut s’agir d’un nom d’appareil (comme 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 le. DRV, mais vous ne devez pas inclure le chemin d’accès au fichier.

lpszOpenFlags

Indicateur qui identifie l’élément à 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 d' appareil _ alias partageable type de _ périphérique de type
digitalvideo alias de l' appareil _ aliaselementname nostatic parent HWND partageable style de style d’un style enfant chevauchement style de style Popup type de type _ périphérique _
superposition alias de l' appareil _ alias parent du style partageable HWND style de style Popup style avec chevauchement style type de type _ périphérique _
sequencer alias d' appareil _ alias partageable type de _ périphérique de type
vidéo alias d' appareil _ alias partageable type de _ périphérique de type
videodisk alias d' appareil _ alias partageable type de _ périphérique de type
WaveAudio alias de la _ taille de la mémoire tampon des _ alias d’appareil _ type de périphérique 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 de l' appareil _ alias Spécifie un autre nom pour l’appareil donné. S’il est spécifié, il doit être utilisé comme _ ID d’appareil dans les commandes suivantes.
ElementName Spécifie le nom de l’élément d’appareil (fichier) chargé lorsque l’appareil s’ouvre.
_ taille de la mémoire tampon de mémoire tampon Définit la taille, en secondes, de la mémoire tampon utilisée par le périphérique Wave-audio. La taille par défaut de la mémoire tampon est définie lorsque le périphérique Wave-audio est installé ou configuré. En règle générale, la taille de la mémoire tampon est définie à 4 secondes. Avec l’appareil MCIWAVE, la taille minimale est de 2 secondes et la taille maximale est de 9 secondes.
HWND parent Spécifie le handle de fenêtre de la fenêtre parente.
partageable Initialise l’appareil ou le fichier comme partageable. Les tentatives suivantes d’ouverture du périphérique ou du fichier échouent, sauf si vous spécifiez « partageable » dans les commandes d’origine et les commandes ouvertes suivantes. MCI retourne une erreur d’appareil non valide si l’appareil est déjà ouvert et ne peut pas être partagé.
Les appareils MCISEQ Sequencer et MCIWAVE ne prennent pas en charge les fichiers partagés.
enfant de style Ouvre une fenêtre avec un style de fenêtre enfant.
chevauchement de style Ouvre une fenêtre avec un style de fenêtre avec chevauchement.
menu contextuel style Ouvre une fenêtre avec un style de fenêtre contextuelle.
_ type de style de style Indique un style de fenêtre.
type de _ périphérique de type Spécifie le type d’appareil d’un fichier.

lpszFlags

Peut être « Wait », « Notify », 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 une erreur.

Notes

MCI réserve « cdaudio » pour le type de périphérique CD audio, « videodisc » pour le type d’appareil videodisc, « Sequencer » pour le type d’appareil MIDI Sequencer, « AVIVideo » pour le type de périphérique vidéo numérique et « WaveAudio » pour le type de périphérique 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’il est enregistré dans le registre ou dans la [ ] section d’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 des deux types de pointeur d’interface, spécifiez un arobase (@) suivi du pointeur d’interface à la place du nom du fichier ou du périphérique pour le paramètre lpszDevice . Pour plus d’informations sur les interfaces de fichier 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 périphérique « nouveau », le pilote de forme d’onde prépare une nouvelle ressource de forme d’onde. La commande attribue l’alias d’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 :

_ nom de l’appareil ! nom de l’élément _

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

L’exemple suivant ouvre le droit. Fichier WAV utilisant l’appareil « WaveAudio ».

open waveaudio!right.wav

Le pilote MCIWAVE requiert un périphérique audio Wave 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