commande SetAudio

La commande SetAudio définit les valeurs associées à la lecture et à la capture audio. Les appareils vidéo numériques et VCR 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 de lecture et de 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 alignement de l' algorithme de l’algorithme sur les graves d' entiers pour factoriser le BitsPerSample du _ nombre de bits bytespersec à l’entrée de clocktime entière quittée sur le volume gauche pour prendre le facteur de sortie dépassement du descripteur de qualité de la durée en cours de déconnexion à droite du volume droit pour factoriser le facteur SamplesPerSec à la source de type entier vers le flux de la chaîne de diffusion en nombre aigus pour factoriser le volume
vidéo désactivé sur le moniteur pour taper numéro de numéro de suivi enregistrer le _ numéro de suivi des enregistrements désactivé enregistrer le _ numéro de piste du suivi des enregistrements sur la source et le type numéro de suivi numéro de piste de _ suivi en fonction du _ numéro de suivi 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 d’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 adhèrent aux 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 des algorithmes audio recommandés par le CCITT (International télégraphe and Telephone consultatif Committee).
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 un entier Définit l’alignement des blocs de données par rapport au début des données Waveform-Audio en entrée.
basses à factoriser Définit le niveau de fréquence basse audio.
BitsPerSample au _ nombre de bits Définit le nombre de bits par échantillon enregistré. Le fichier est enregistré dans ce format. Cet indicateur s’applique uniquement aux appareils prenant en charge l’algorithme « PCM ».
bytespersec à un 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.
clocktime Indique que l’heure spécifiée dans l’indicateur « sur » est exprimée en millisecondes. Cette heure est absolue et n’est pas à l’étape de la diffusion de l’espace de travail.
entrée Modifie l’indicateur « Bass », « aigu » ou « volume » pour 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 l’analyse de l’entrée.
quitté à gauche Active ou désactive la sortie audio sur le canal de gauche. La source de présentation audio peut être l’entrée externe ou l’espace de travail. La valeur par défaut est « gauche sur ». 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 de gauche. S’il n’existe qu’un seul canal, il définit son volume.
analyser pour taper le numéro numéro Contrôle l’entrée source qui sera transmise à 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 le nombre n’est pas spécifié, la première entrée de ce type sera choisie.
désactivé le Active ou désactive l’audio. La source de présentation audio peut être soit l’entrée externe, soit l’espace de travail. Cette commande affecte les canaux audio de gauche et de droite simultanément. La valeur par défaut est SetAudio "on".
sortie Modifie l’indicateur « Bass », « aigus » ou « volume » pour modifier uniquement le signal joué et non ce qui est enregistré. Si possible, il s’agit de la valeur par défaut lors de l’analyse d’un fichier.
au-delà de la durée Spécifie la durée nécessaire pour effectuer une modification qui utilise une variable facteur . Les unités de durée sont au format d’heure actuel. Les modifications se produisent à l’étape avec la diffusion de l’espace de travail. Lorsque la lecture est suspendue, la modification est également suspendue jusqu’à ce que la lecture se poursuive. Si « supérieur à » n’est pas spécifié ou n’est pas 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é, le réglage « qualité » s’applique à l’algorithme actuel.
La commande Quality peut être utilisée pour définir des noms de descripteurs supplémentaires.
enregistrement désactivé Efface la sélection de la source audio pour qu’aucun son ne soit enregistré à l’aide de la commande d' enregistrement suivante.
enregistrer sur Active l’enregistrement des données audio. La valeur par défaut consiste à enregistrer des données audio.
enregistrer le _ numéro de piste de piste désactivé Efface la sélection de la source audio pour qu’aucun son ne soit enregistré à l’aide de la commande d' enregistrement suivante. « Track » permet une sélection de suivi indépendante. Track 2 correspond à la piste PCM dans Hi8. Si « Track » n’est pas spécifié, la valeur par défaut 1 est utilisée.
enregistrer le _ numéro de piste du suivi sur Sélectionne la source audio à enregistrer à l’aide de la commande enregistrement suivante. « Track » permet une sélection de suivi indépendante. Track 2 correspond à la piste PCM dans Hi8. Si « Track » n’est pas spécifié, la valeur par défaut 1 est utilisée.
avec le bouton droit Active ou désactive la sortie audio sur le canal approprié. 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 approprié à factoriser Définit le volume audio sur le canal audio de droite. S’il n’y a qu’un seul canal, il n’a aucun effet.
SamplesPerSec à un entier Définit le taux d’échantillonnage pour l’enregistrement avec les algorithmes « PCM » et « ADPCM ». Le fichier est enregistré dans ce format.
source au SourceName Spécifie la source du digitaliseur d’entrée audio. Les constantes définies pour SourceName sont les suivantes : « Left », « Right », « Average » et « Stereo ». Les trois premiers spécifient l’enregistrement Monophonic à l’aide de l’entrée de gauche uniquement, l’entrée de droite uniquement et la moyenne des deux entrées.
Numéro de la source au type numéro Sélectionne la source audio à enregistrer sur la bande. Le type doit être « tuner », « line », « Svideo », « aux », « Generic » ou « MUTE ».
diffuser en nombre Spécifie que le flux audio est 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é est joué physiquement en premier.
suivre le _ numéro de piste désactivé Désactive une piste individuelle.
suivre le _ numéro de suivi sur Active une piste individuelle.
aigus à factoriser Définit le niveau haute fréquence audio.
volume à factoriser Définit le volume audio moyen pour les deux canaux audio. Si les volumes de gauche et de droite ont été définis sur des valeurs différentes, le rapport entre le volume de gauche et de droite n’est pas modifié.

lpszFlags

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

Remarques

Pour les périphériques VCR, l’utilisation de SetAudio avec un indicateur qui désactive une piste individuelle (« suivre le _ numéro de suivi ») peut entraîner la réception par votre application d’un message d’état indiquant que la commande n’a pas pu être exécutée. Certains magnétoscopes peuvent désactiver uniquement les combinaisons de pistes, pas les 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 dans 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

reserve

setvideo