Comando setaudio

Il comando setaudio imposta i valori associati alla riproduzione e all'acquisizione dell'audio. I dispositivi digital-video e VCR riconoscono questo comando.

Per inviare questo comando, chiamare la funzione mciSendString con il set di parametri lpszCommand come indicato di seguito.

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

Parametri

lpszDeviceID

Identificatore di un dispositivo MCI. Questo identificatore o alias viene assegnato all'apertura del dispositivo.

lpszAudio

Contrassegno per la riproduzione e l'acquisizione audio. Nella tabella seguente sono elencati i tipi di dispositivo che riconoscono il comando setaudio e i flag usati da ogni tipo.

Valore	Significato	Significato
digitalvideo	algoritmo algorithmalignment to integerbass to factorbitspersample to bit_count bytespersec to integerclocktime input left off on left on left volume to factoroff on output	nel corso della durata, il record del descrittoredi qualità al di fuori del record a destra sul volume destro per fattoriaresamplespersec fino all'origine integerfino al flusso sourcenameal numerotreble to factorvolume to factor
Vcr	off on monitor to typenumber numberrecord off record track track_number off	record sulla traccia record track_number sull'origine per digitarenumerodi traccia track_number fuori traccia track_number

Nella tabella seguente sono elencati i flag che possono essere specificati nel parametro lpszAudio e i relativi significati.

Valore	Significato
algoritmo algoritmo	Seleziona un algoritmo di compressione audio specifico per l'uso da parte di un comando di riserva o record successivo. Gli algoritmi supportati sono specifici del dispositivo. MCI definisce i valori "g711", "g721", "g722", "g728", "pcm", "cdxa", "adpcm" e "adpcm4e" per l'algoritmo. Se un dispositivo supporta i nomi di algoritmo "pcm", "cdxa" e "adpcm4e", rispettano le definizioni standard. L'algoritmo "cdxa" è stato definito da Sony Corporation. L'algoritmo "adpcm4e" è stato definito da Intel Corporation. I valori "g711", "g721", "g722" e "g728" rappresentano gli algoritmi audio consigliati dal Comitato consultivo telefonico e telegrafico internazionale (CCITT). Se l'algoritmo specificato è in conflitto con il formato di file corrente, il formato del file viene modificato nel formato predefinito per l'algoritmo.
allineamento a integer	Imposta l'allineamento dei blocchi di dati rispetto all'inizio dei dati audio della forma d'onda di input.
basso a fattore	Imposta il livello di bassa frequenza audio.
bitspersample per bit_count	Imposta il numero di bit per campione registrato. Il file viene salvato in questo formato. Questo flag si applica solo ai dispositivi che supportano l'algoritmo "pcm".
bytepersec a integer	Imposta il numero medio di byte al secondo per la registrazione negli algoritmi "pcm" e "adpcm". Il file viene salvato in questo formato.
clocktime	Indica l'ora specificata nel flag "over" in millisecondi. Questa volta è assoluto e non è in fase di riproduzione dell'area di lavoro.
input	Modifica il flag "bass", "treble" o "volume" in modo che influisca sul segnale di input e modifichi ciò che viene registrato. Se possibile, si tratta dell'impostazione predefinita durante il monitoraggio dell'input.
left off left on	Abilita o disabilita l'output audio nel canale sinistro. L'origine della presentazione audio può essere l'input esterno o l'area di lavoro. Il valore predefinito è "left on". Se è presente un solo canale, il canale è attivato o disattivato.
volume a sinistra a fattore	Imposta il volume audio del canale audio sinistro. Se è presente un solo canale, imposta il volume.
monitor to typenumber number	Controlla l'input di origine che verrà passato all'output VCR senza modificare la selezione dell'input di origine della registrazione. Il tipo può essere "output" o una delle origini di input valide. Se il numero non viene specificato, verrà scelto il primo input di quel tipo.
disattivato	Abilita o disabilita l'audio. L'origine della presentazione audio può essere l'input esterno o l'area di lavoro. Questo comando influisce simultaneamente sui canali audio sinistro e destro. Il valore predefinito è setaudio "on".
output	Modifica il flag "bass", "treble" o "volume" in modo che modifichi solo il segnale riprodotto e non quello registrato. Se possibile, si tratta dell'impostazione predefinita durante il monitoraggio di un file.
nel corso della durata	Specifica il tempo necessario per apportare una modifica che usa una variabile di fattore . Le unità per la durata sono nel formato ora corrente. Le modifiche si verificano nel passaggio con la riproduzione dell'area di lavoro. Quando si gioca è sospeso, la modifica viene sospesa anche fino a quando il gioco continua. Se "over" non è specificato o non è supportato, la modifica viene eseguita immediatamente.
descrittore di qualità	Specifica le caratteristiche della compressione audio eseguita quando l'audio viene registrato in un file. Tutti i dispositivi supportano i tre descrittori "low", "medium" e "high". Il valore predefinito è specifico del dispositivo. Se il flag "algorithm" non è specificato, la regolazione "qualità" si applica all'algoritmo corrente. Il comando quality può essere usato per definire nomi di descrittore aggiuntivi.
record off	Cancella la selezione dell'origine audio in modo che nessun audio venga registrato con il comando record successivo.
record su	Abilita la registrazione dei dati audio. L'impostazione predefinita consiste nel registrare i dati audio.
record track track_number off	Cancella la selezione dell'origine audio in modo che nessun audio venga registrato con il comando record successivo. "Track" consente la selezione indipendente delle tracce. La traccia 2 corrisponde alla traccia PCM in Hi8. Se "track" non viene specificato, viene utilizzato un valore predefinito pari a 1.
record track track_number on	Seleziona l'origine audio da registrare con il comando record successivo. "Track" consente la selezione indipendente delle tracce. La traccia 2 corrisponde alla traccia PCM in Hi8. Se "track" non viene specificato, viene utilizzato un valore predefinito pari a 1.
destra destra su	Abilita o disabilita l'output audio nel canale destro. L'origine della presentazione audio può essere l'input esterno o l'area di lavoro. Il valore predefinito è "a destra". Se è presente un solo canale, questo flag non ha alcun effetto.
volume giusto per fattore	Imposta il volume audio sul canale audio corretto. Se esiste un solo canale, non ha alcun effetto.
samplespersec to integer	Imposta la frequenza di esempio per la registrazione con gli algoritmi "pcm" e "adpcm". Il file viene salvato in questo formato.
source to sourcename	Specifica l'origine per il digitalizzatore di input audio. Le costanti definite per il nome sorgente includono: "left", "right", "average" e "stereo". I primi tre specificano la registrazione monofonica usando solo l'input sinistro, l'input destro solo e la media dei due input.
origine per digitarenumero	Seleziona l'origine audio da registrare sul nastro. Il tipo deve essere "tuner", "line", "svideo", "aux", "generic" o "mute".
flusso al numero	Specifica il flusso audio riprodotto dall'area di lavoro. Se il flusso non è specificato e il formato di file non definisce un valore predefinito, verrà riprodotto il flusso audio interleaved che viene eseguito fisicamente.
tenere traccia track_number fuori	Disabilita una singola traccia.
tenere traccia track_number su	Abilita una singola traccia.
treble to factor	Imposta il livello di alta frequenza audio.
volume a fattore	Imposta il volume audio medio per entrambi i canali audio. Se i volumi sinistro e destro sono stati impostati su valori diversi, il rapporto del volume a sinistra a destra è approssimativamente invariato.

lpszFlags

Può essere "wait", "notify", "test" o una combinazione di queste. Per altre informazioni su questi flag, vedere Attesa, notifica e flag di test.

Valore restituito

Restituisce zero se ha esito positivo o un errore in caso contrario.

Commenti

Per i dispositivi VCR, l'uso di setaudio con un flag che disattiva una singola traccia ("tenere traccia track_number disattivata") potrebbe causare la ricezione di un messaggio di stato dell'applicazione che indica che il comando non può essere eseguito. Alcuni VCR possono disattivare solo combinazioni di tracce, non singole tracce; ad esempio, la prima traccia audio e una traccia video di una cassetta video. In questo caso, usare semplicemente setaudio e setvideo per continuare a disattivare le altre tracce che costituiscono la combinazione. Il driver disattiva le tracce quando riceve il comando per disattivare l'ultima traccia nella combinazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]

Vedi anche

MCI

Stringhe di comando MCI

Registrazione

Riserva

setvideo