commande MCI_OPEN
La commande MCI_OPEN initialise un appareil ou un fichier. Tous les appareils reconnaissent cette commande.
Pour envoyer cette commande, appelez la fonction mciSendCommand avec les paramètres suivants.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_OPEN,
DWORD dwFlags,
(DWORD) (LPMCI_OPEN_PARMS) lpOpen
);
Paramètres
-
wDeviceID
-
Identificateur de l’appareil MCI devant recevoir le message de commande.
-
dwFlags
-
MCI_NOTIFY ou MCI_WAIT. Pour plus d’informations sur ces indicateurs, consultez Indicateurs d’attente, de notification et de test.
-
lpOpen
-
Pointeur vers une structure MCI_OPEN_PARMS . (Les appareils avec des jeux de commandes étendus peuvent remplacer cette structure par une structure spécifique à l’appareil.)
Valeur renvoyée
Retourne zéro en cas de réussite ou une erreur dans le cas contraire.
Notes
L’indicateur MCI_OPEN_TYPE doit être utilisé chaque fois qu’un appareil est spécifié dans la fonction mciSendCommand . Si vous ouvrez un appareil en spécifiant une constante de type d’appareil, vous devez spécifier l’indicateur MCI_OPEN_TYPE_ID en plus de MCI_OPEN_TYPE. Pour obtenir la liste des constantes de type d’appareil, consultez Types d’appareils MCI.
Si l’indicateur MCI_OPEN_SHAREABLE n’est pas spécifié lors de l’ouverture initiale d’un appareil ou d’un fichier, toutes les commandes de MCI_OPEN suivantes sur l’appareil ou le fichier échouent. Si l’appareil ou le fichier est déjà ouvert et que cet indicateur n’est pas spécifié, l’appel échoue même si la première commande d’ouverture spécifiée MCI_OPEN_SHAREABLE. Fichiers ouverts pour MCISEQ. DRV et MCIWAVE. Les appareils DRV ne sont pas partageables.
La casse est ignorée dans le nom de l’appareil, mais il ne peut pas y avoir de blancs de début ou de fin.
Pour utiliser la sélection automatique du type (via les entrées du Registre), affectez le nom de fichier et l’extension de fichier au membre lpstrElementName de la structure identifiée par lpOpen, affectez au membre lpstrDeviceType la valeur NULL et définissez l’indicateur MCI_OPEN_ELEMENT.
Les indicateurs supplémentaires suivants s’appliquent à tous les appareils prenant en charge MCI_OPEN :
-
MCI_OPEN_ALIAS
-
Un alias est inclus dans le membre lpstrAlias de la structure identifiée par lpOpen.
-
MCI_OPEN_SHAREABLE
-
L’appareil ou le fichier doit être ouvert comme pouvant être partagé.
-
MCI_OPEN_TYPE
-
Un nom ou une constante de type d’appareil est inclus dans le membre lpstrDeviceType de la structure identifiée par lpOpen.
-
MCI_OPEN_TYPE_ID
-
Le mot d’ordre bas du membre lpstrDeviceType de la structure identifiée par lpOpen contient un identificateur de type d’appareil MCI standard et le mot d’ordre élevé contient éventuellement l’index ordinal de l’appareil. Utilisez cet indicateur avec l’indicateur MCI_OPEN_TYPE.
Les indicateurs supplémentaires suivants s’appliquent aux appareils composés :
-
MCI_OPEN_ELEMENT
-
Un nom de fichier est inclus dans le membre lpstrElementName de la structure identifiée par lpOpen.
-
MCI_OPEN_ELEMENT_ID
-
Le membre lpstrElementName de la structure identifiée par lpOpen est interprété comme une valeur DWORD et a une signification interne à l’appareil. Utilisez cet indicateur avec l’indicateur MCI_OPEN_ELEMENT.
Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil digitalvideo :
-
MCI_DGV_OPEN_NOSTATIC
-
L’appareil doit réduire le nombre de couleurs statiques (système) dans la palette. Cela augmente le nombre de couleurs disponibles pour le rendu du flux vidéo. Cet indicateur s’applique uniquement aux appareils qui partagent une palette avec Windows.
-
MCI_DGV_OPEN_PARENT
-
Le handle de fenêtre parent est spécifié dans le membre hWndParent de la structure identifiée par lpOpen.
-
MCI_DGV_OPEN_WS
-
Un style de fenêtre est spécifié dans le membre dwStyle de la structure identifiée par lpOpen.
-
MCI_DGV_OPEN_16BIT
-
Indique une préférence pour la prise en charge des appareils MCI 16 bits.
-
MCI_DGV_OPEN_32BIT
-
Indique une préférence pour la prise en charge des appareils MCI 32 bits.
Pour les appareils vidéo numériques, le paramètre lpOpen pointe vers une structure MCI_DGV_OPEN_PARMS .
Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil de superposition :
-
MCI_OVLY_OPEN_PARENT
-
Le handle de fenêtre parent est spécifié dans le membre hWndParent de la structure identifiée par lpOpen.
-
MCI_OVLY_OPEN_WS
-
Un style de fenêtre est spécifié dans le membre dwStyle de la structure identifiée par lpOpen. La valeur dwStyle spécifie le style de la fenêtre que le pilote va créer et afficher si l’application n’en fournit pas. Le paramètre style prend un entier qui définit le style de fenêtre. Ces constantes sont les mêmes que les styles de fenêtre standard (par exemple, WS_CHILD, WS_OVERLAPPEDWINDOW ou WS_POPUP).
Pour les appareils de superposition vidéo, le paramètre lpOpen pointe vers une structure MCI_OVLY_OPEN_PARMS .
L’indicateur supplémentaire suivant est utilisé avec le type d’appareil waveaudio :
-
MCI_WAVE_OPEN_BUFFER
-
Une longueur de mémoire tampon est spécifiée dans le membre dwBufferSeconds de la structure identifiée par lpOpen.
Pour les appareils audio de forme d’onde, le paramètre lpOpen pointe vers une structure MCI_WAVE_OPEN_PARMS . 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 |
|