commande setaudio

La commande 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 mciSendString avec le paramètre lpszCommand défini comme suit.

_stprintf_s(
  lpszCommand, 
  TEXT("setaudio %s %s %s"), 
  lpszDeviceID, 
  lpszAudio, 
  lpszFlags
); 

Paramètres

lpszDeviceID

Identificateur d’un appareil MCI. Cet identificateur ou alias est attribué lorsque l’appareil est ouvert.

lpszAudio

Indicateur pour la lecture et la capture audio. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande setaudio et les indicateurs utilisés par chaque type.

Valeur	Signification	Signification
digitalvideo	algorithme alignement de l’algorithmesur les entiersbass pour factorbitspersample à bit_count octetspersec à entierhorloge entrée gauche sur le volume gauche pour factorisersur la sortie	sur la duréedu descripteur dequalité enregistrement hors enregistrement à droite sur le volume droit à factorsamplespersec to integersource to sourcenamestream to numbertriple to factorvolume to factor
Magnétoscope	off on monitor to typenumber recordoff record track_number off	enregistrer sur la piste d’enregistrement track_number sur la source pour taper la piste numérotrack_number hors piste track_number sur

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

Valeur	Signification
algorithme	Sélectionne un algorithme de compression audio spécifique à utiliser par une commande de réserve ou d’enregistrement ultérieure. Les algorithmes pris en charge sont spécifiques à l’appareil. MCI définit les valeurs « g711 », « g721 », « g722 », « g728 », « pcm », « cdxa », « adpcm » et « adpcm4e » pour l’algorithme. Si un appareil prend en charge les noms d’algorithmes « pcm », « cdxa » et « adpcm4e », ils respectent les définitions standard. L’algorithme « cdxa » a été défini par Sony Corporation. L’algorithme « adpcm4e » a été défini par Intel Corporation. Les valeurs « g711 », « g721 », « g722 » et « g728 » représentent les algorithmes audio recommandés par le Comité consultatif international télégraphique et téléphonique (CCITT). Si l’algorithme spécifié est en conflit avec le format de fichier actuel, le format de fichier est remplacé par le format par défaut de l’algorithme.
alignement sur entier	Définit l’alignement des blocs de données par rapport au début des données audio de forme d’onde d’entrée.
basses à factoriser	Définit le niveau de basse fréquence audio.
bitspersample pour bit_count	Définit le nombre de bits par exemple enregistré. Le fichier est enregistré dans ce format. Cet indicateur s’applique uniquement aux appareils prenant en charge l’algorithme « pcm ».
octetspersec en entier	Définit le nombre moyen d’octets par seconde pour l’enregistrement dans les algorithmes « pcm » et « adpcm ». Le fichier est enregistré dans ce format.
heure de l’horloge	Indique que l’heure spécifiée dans l’indicateur « over » est en millisecondes. Ce temps est absolu et ne correspond pas au jeu de l’espace de travail.
entrée	Modifie l’indicateur « basse », « aiguë » ou « 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.
laissé à gauche sur	Active ou désactive la sortie audio sur le canal gauche. La source de présentation audio peut être l’entrée externe ou l’espace de travail. La valeur par défaut est « left on ». S’il n’existe qu’un seul canal, ce canal est activé ou désactivé.
volume gauche à factoriser	Définit le volume audio du canal audio gauche. S’il n’existe qu’un seul canal, il définit son volume.
monitor to type number number	Contrôle l’entrée source qui sera passée à la sortie du magnétoscope sans modifier la sélection d’entrée de la source d’enregistrement. Le type peut être « output » ou l’une des sources d’entrée valides. Si nombre n’est pas spécifié, la première entrée de ce type est choisie.
désactivé le	Active ou désactive l’audio. La source de présentation audio peut être l’entrée externe ou l’espace de travail. Cette commande affecte simultanément les canaux audio gauche et droit. La valeur par défaut est setaudio « on ».
sortie	Modifie l’indicateur « basse », « aigu » ou « 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 d’un fichier.
sur la durée	Spécifie le temps nécessaire pour apporter une modification qui utilise une variable de facteur . Les unités de durée sont au format d’heure actuel. Les modifications se produisent au cours de la lecture de l’espace de travail. Lorsque la lecture est suspendue, la modification est également suspendue jusqu’à ce que la lecture se poursuive. Si « over » n’est pas spécifié ou non pris en charge, la modification se produit immédiatement.
descripteur de qualité	Spécifie les caractéristiques de la compression audio effectuée lorsque l’audio est enregistré dans un fichier. Tous les appareils prennent en charge les trois descripteurs « low », « medium » et « high ». La valeur par défaut est spécifique à l’appareil. Si l’indicateur « algorithme » n’est pas spécifié, l’ajustement « qualité » s’applique à l’algorithme actuel. La commande qualité peut être utilisée pour définir des noms de descripteurs supplémentaires.
enregistrement désactivé	Efface la sélection de la source audio afin qu’aucun audio ne soit enregistré avec la commande d’enregistrement suivant.
enregistrer sur	Active l’enregistrement des données audio. La valeur par défaut consiste à enregistrer des données audio.
enregistrement track_number désactivé	Efface la sélection de la source audio afin qu’aucun audio ne soit enregistré avec la commande d’enregistrement suivant. « Suivi » permet la sélection de piste indépendante. La piste 2 correspond à la piste PCM dans Hi8. Si « track » n’est pas spécifié, une valeur par défaut de 1 est supposée.
enregistrer des track_number de suivi sur	Sélectionne la source audio à enregistrer avec la commande d’enregistrement suivante. « Suivi » permet la sélection de piste indépendante. La piste 2 correspond à la piste PCM dans Hi8. Si « track » n’est pas spécifié, une valeur par défaut de 1 est supposée.
à droite sur	Active ou désactive la sortie audio sur le canal droit. La source de présentation audio peut être l’entrée externe ou l’espace de travail. La valeur par défaut est « right on ». S’il n’existe qu’un seul canal, cet indicateur n’a aucun effet.
volume droit à factoriser	Définit le volume audio sur le canal audio approprié. S’il n’existe qu’un seul canal, cela n’a aucun effet.
samplespersec en entier	Définit le taux d’échantillonnage pour l’enregistrement avec les algorithmes « pcm » et « adpcm ». Le fichier est enregistré dans ce format.
source à nom de source	Spécifie la source du numériseur d’entrée audio. Les constantes définies pour le nom de la source sont les suivantes : « left », « right », « average » et « stereo ». Les trois premiers spécifient l’enregistrement monophonique à l’aide de l’entrée gauche uniquement, de l’entrée droite uniquement et de la moyenne des deux entrées.
numéro de source à type	Sélectionne la source audio à enregistrer sur la bande. Le type doit être « tuner », « line », « svideo », « aux », « generic » ou « mute ».
stream to number	Spécifie le flux audio lu à partir de l’espace de travail. Si le flux n’est pas spécifié et que le format de fichier ne définit pas de valeur par défaut, le flux audio entrelacé qui est d’abord physiquement est lu.
suivre track_number désactivé	Désactive une piste individuelle.
suivre track_number sur	Active une piste individuelle.
triple à facteur	Définit le niveau de haute fréquence audio.
volume à facteur	Définit le volume audio moyen pour les deux canaux audio. Si les volumes gauche et droit ont été définis sur des valeurs différentes, le ratio du volume de gauche à droite est à peu près inchangé.

lpszFlags

Il peut s’agir de « wait », « notify », « test » ou d’une combinaison de ceux-ci. 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 d’erreur dans le cas contraire.

Notes

Pour les appareils magnétoscopes, l’utilisation de setaudio avec un indicateur qui désactive une piste individuelle (« suivre track_number désactivé ») peut entraîner la réception d’un message status indiquant que la commande n’a pas pu être exécutée. Certains magnétoscopes ne peuvent désactiver que des combinaisons de pistes, et non des pistes individuelles ; par exemple, la première piste audio et une piste vidéo d’une cassette vidéo. Dans ce cas, utilisez simplement setaudio et setvideo pour continuer à désactiver les autres pistes qui composent la combinaison. Le pilote désactive les pistes lorsqu’il reçoit la commande pour désactiver la dernière piste de la combinaison.

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]

Voir aussi

MCI

Chaînes de commande MCI

enregistrement

Réserve

setvideo