commande MCI_SETAUDIO

La commande MCI_SETAUDIO définit les valeurs associées à la lecture et à la capture audio. Les appareils de vidéo numérique et de magnétoscope reconnaissent cette commande.

Pour envoyer cette commande, appelez la fonction mciSendCommand avec les paramètres suivants.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SETAUDIO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpSetAudio
);

Paramètres

wDeviceID

Identificateur d’appareil de l’appareil MCI qui doit recevoir le message de commande.

dwFlags

MCI_NOTIFY, MCI_WAIT ou MCI_TEST. Pour plus d’informations sur ces indicateurs, consultez Les indicateurs d’attente, de notification et de test.

lpSetAudio

Pointeur vers une structure MCI_GENERIC_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 d’erreur dans le cas contraire.

Notes

Les indicateurs suivants s’appliquent au type d’appareil digitalvideo :

MCI_DGV_SETAUDIO_ALG

Le membre lpstrAlgorithm de la structure identifiée par lpSetAudio contient l’adresse d’une mémoire tampon contenant le nom d’un algorithme de compression audio. L’algorithme de compression est utilisé par les commandes MCI_RESERVE ou MCI_RECORD suivantes. Les algorithmes disponibles dépendent de l’appareil. Si l’algorithme n’est pas compatible avec le format de fichier actuel, le format de fichier est remplacé par le format par défaut de l’algorithme.

MCI_DGV_SETAUDIO_CLOCKTIME

L’heure spécifiée est en millisecondes et est une heure absolue lorsqu’elle est utilisée avec MCI_DGV_SETAUDIO_OVER. (Cette fois n’est pas en parallèle avec le jeu de l’espace de travail.)

MCI_DGV_SETAUDIO_INPUT

Modifie l’indicateur de basses, d’aigus ou de volume afin qu’il affecte le signal d’entrée et modifie ce qui est enregistré. Si possible, il s’agit de la valeur par défaut lors de la surveillance de l’entrée.

MCI_DGV_SETAUDIO_ITEM

Une constante audio est spécifiée dans le membre dwItem de la structure identifiée par lpSetAudio. La constante identifie la valeur en cours de définition. Les constantes suivantes sont définies :

MCI_DGV_SETAUDIO_AVGBYTESPERSEC

Le nombre moyen d’octets est spécifié dans le membre dwValue de la structure identifiée par lpSetAudio. Cette valeur définit le nombre moyen d’octets par seconde pour la lecture ou l’enregistrement dans les formats PCM (Pulse Code Modulation) et ADPCM (Adaptive Differential Pulse Code Modulation). Le fichier est enregistré dans ce format.

MCI_DGV_SETAUDIO_BASS

Le niveau de basse fréquence audio est spécifié en tant que facteur dans le membre dwValue de la structure identifiée par lpSetAudio.

MCI_DGV_SETAUDIO_BITSPERSAMPLE

Le nombre de bits par exemple est spécifié dans le membre dwValue de la structure identifiée par lpSetAudio. Cette valeur définit le nombre de bits par exemple lus ou enregistrés au format PCM. Le fichier est enregistré dans ce format.

MCI_DGV_SETAUDIO_BLOCKALIGN

L’alignement du bloc de données est spécifié dans le membre dwValue de la structure identifiée par lpSetAudio. Cette valeur définit l’alignement des blocs de données par rapport au début des données de forme d’onde d’entrée.

MCI_DGV_SETAUDIO_SAMPLESPERSEC

Le taux d’échantillonnage est spécifié dans le membre dwValue de la structure identifiée par lpSetAudio. Cette valeur définit le taux d’échantillonnage pour la lecture et l’enregistrement avec les algorithmes PCM et ADPCM. Le fichier est enregistré dans ce format.

MCI_DGV_SETAUDIO_SOURCE

Une constante spécifiant la source d’entrée audio est incluse dans le membre dwValue de la structure identifiée par lpSetAudio. Les constantes suivantes sont définies pour les sources d’entrée audio :

MCI_DGV_SETAUDIO_SOURCE_AVERAGE

Moyenne des canaux audio gauche et droit.

MCI_DGV_SETAUDIO_SOURCE_LEFT

Canal audio gauche.

MCI_DGV_SETAUDIO_SOURCE_RIGHT

Canal audio droit.

MCI_DGV_SETAUDIO_SOURCE_STEREO

Stéréo.

MCI_DGV_SETAUDIO_STREAM

Un flux audio est spécifié dans le membre dwValue de la structure identifiée par lpSetAudio. La valeur entière spécifie le flux audio lu à partir de l’espace de travail. Si le flux n’est pas spécifié, le premier flux audio physiquement entrelacé est lu.

MCI_DGV_SETAUDIO_TREBLE

Le niveau de haute fréquence audio est spécifié en tant que facteur dans le membre dwValue de la structure identifiée par lpSetAudio.

MCI_DGV_SETAUDIO_VOLUME

Le niveau audio d’un ou des deux canaux audio est spécifié en tant que facteur dans le membre dwValue de la structure identifiée par lpSetAudio. Si les volumes gauche et droit ont été définis sur des valeurs différentes, le rapport entre le volume gauche et droit est à peu près inchangé.

MCI_DGV_SETAUDIO_LEFT

Active le canal audio gauche lorsqu’il est utilisé avec MCI_SET_ON. Désactive le canal audio gauche lorsqu’il est utilisé avec MCI_SET_OFF. Lorsque cet indicateur est utilisé avec la combinaison de MCI_DGV_SETAUDIO_VALUE et de MCI_DGV_SETAUDIO_VOLUME, il définit le volume du canal audio gauche. Lorsque cet indicateur est utilisé avec MCI_DGV_SETAUDIO_SOURCE, il spécifie le canal audio gauche comme source pour le numériseur d’entrée audio.

MCI_DGV_SETAUDIO_OVER

Un paramètre de longueur de transition est inclus dans le membre dwOver de la structure identifiée par lpSetAudio. La valeur de longueur spécifie la durée (en unités du format d’heure actuel) nécessaire pour apporter une modification qui utilise un facteur. Si cet indicateur n’est pas utilisé, des modifications se produisent immédiatement.

MCI_DGV_SETAUDIO_QUALITY

Le membre lpstrQuality de la structure identifiée par lpSetAudio contient l’adresse d’une mémoire tampon définissant la qualité audio. Une chaîne de texte dans la mémoire tampon spécifie les caractéristiques de l’algorithme de compression audio.

L’indicateur MCI_DGV_SETAUDIO_ALG peut être utilisé pour sélectionner un descripteur de qualité pour l’algorithme spécifié. Si cet indicateur est omis, l’algorithme actuel est utilisé.

Les algorithmes et les noms de descripteurs disponibles dépendent de l’appareil. Chaque appareil fournit une documentation pour les algorithmes disponibles et une description des noms de descripteurs applicables. La commande MCI_QUALITY peut définir des noms de descripteurs supplémentaires.

MCI_DGV_SETAUDIO_RECORD

Spécifie si l’enregistrement inclut ou exclut les données audio. Lorsqu’elles sont combinées à MCI_SET_ON, les données audio sont enregistrées. Lorsqu’elles sont combinées à MCI_SET_OFF, les données audio sont exclues. La valeur par défaut inclut les données audio.

MCI_DGV_SETAUDIO_RIGHT

Active le canal audio approprié lorsqu’il est utilisé avec MCI_SET_ON. Désactive le canal audio approprié lorsqu’il est utilisé avec MCI_SET_OFF. Lorsque cet indicateur est utilisé avec la combinaison de MCI_DGV_SETAUDIO_VALUE et de MCI_DGV_SETAUDIO_VOLUME, il définit le volume du canal audio approprié.

MCI_DGV_SETAUDIO_VALUE

Une valeur est spécifiée dans le membre dwValue de la structure identifiée par lpSetAudio. La signification de la valeur est spécifiée par la constante définie pour l’indicateur MCI_DGV_SETAUDIO_ITEM.

MCI_SET_OFF

Désactive le canal audio spécifié.

MCI_SET_ON

Active le canal audio spécifié.

MCI_SETAUDIO_OUTPUT

Modifie l’indicateur de basse, d’aigus ou de volume afin qu’il modifie uniquement le signal lu et non ce qui est enregistré. Si possible, il s’agit de la valeur par défaut lors de la surveillance de l’entrée.

Pour les appareils vidéo numériques, le paramètre lpSetAudio pointe vers une structure MCI_DGV_SETAUDIO_PARMS .

Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil vcr :

MCI_VCR_SETAUDIO_RECORD

Définit l’enregistrement audio sur activé ou désactivé, qui est utilisé conjointement avec l’un des indicateurs suivants :

MCI_SET_ON

Enregistrement audio activé.

MCI_SET_OFF

Enregistrement audio désactivé. Il peut être nécessaire de désactiver d’abord l’enregistrement d’assemblage (à l’aide de la commande MCI_SET avec l’indicateur MCI_VCR_SET_ASSEMBLE_RECORD défini sur désactivé) avant de désactiver l’enregistrement audio.

MCI_TRACK

Le membre dwTrack de la structure identifiée par lpSetAudio spécifie la piste affectée par la commande .

MCI_VCR_SETAUDIO_SOURCE

Définit la source audio. Cet indicateur doit être utilisé avec l’indicateur MCI_VCR_SETAUDIO_TO.

MCI_VCR_SETAUDIO_MONITOR

Définit le moniteur de source audio. Cet indicateur doit être utilisé avec l’indicateur MCI_VCR_SETAUDIO_TO.

MCI_VCR_SETAUDIO_TO

Le membre dwTo de la structure identifiée par lpSetAudio contient une constante décrivant le type d’entrée ou d’entrée surveillée. Il doit s’agir de l’un des éléments suivants :

MCI_VCR_SRC_TYPE_TUNER

Le type est tuner.

MCI_VCR_SRC_TYPE_LINE

Le type est ligne.

MCI_VCR_SRC_TYPE_AUX

Le type est auxiliaire.

MCI_VCR_SRC_TYPE_GENERIC

Le type est générique.

MCI_VCR_SRC_TYPE_MUTE

Le type est désactivé. Cela ne peut être utilisé qu’avec l’indicateur MCI_VCR_SETAUDIO_SOURCE.

MCI_VCR_SRC_TYPE_OUTPUT

Type est sortie.

MCI_VCR_SETAUDIO_NUMBER

Le membre dwNumber de la structure identifiée par lpSetAudio contient l’entrée audio (du type spécifié dans le membre dwTo) à utiliser.

Pour les appareils VCR, le paramètre lpSetAudio pointe vers une structure MCI_VCR_SETAUDIO_PARMS .

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	Mmsystem.h (inclure Windows.h)

Voir aussi

MCI

Commandes MCI