comando MCI_SETAUDIO

Il comando MCI_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 mciSendCommand con i parametri seguenti.

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

Parametri

wDeviceID

Identificatore del dispositivo MCI che deve ricevere il messaggio di comando.

Dwflags

MCI_NOTIFY, MCI_WAIT o MCI_TEST. Per informazioni su questi flag, vedere Flag di attesa, notifica e test.

lpSetAudio

Puntatore a una struttura MCI_GENERIC_PARMS . I dispositivi con set di comandi estesi potrebbero sostituire questa struttura con una struttura specifica del dispositivo.

Valore restituito

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

Commenti

I flag seguenti si applicano al tipo di dispositivo digitalvideo :

MCI_DGV_SETAUDIO_ALG

Il membro lpstrAlgorithm della struttura identificata da lpSetAudio contiene un indirizzo di un buffer contenente il nome di un algoritmo di compressione audio. L'algoritmo di compressione viene usato dai comandi MCI_RESERVE o MCI_RECORD successivi. Gli algoritmi disponibili dipendono dal dispositivo. Se l'algoritmo non è compatibile con il formato di file corrente, il formato del file viene modificato nel formato predefinito per l'algoritmo.

MCI_DGV_SETAUDIO_CLOCKTIME

Il tempo specificato è espresso in millisecondi ed è l'ora assoluta quando viene usata con MCI_DGV_SETAUDIO_OVER. Questa volta non è in fase di riproduzione dell'area di lavoro.

MCI_DGV_SETAUDIO_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.

MCI_DGV_SETAUDIO_ITEM

Una costante audio viene specificata nel membro dwItem della struttura identificata da lpSetAudio. La costante identifica il valore impostato. Vengono definite le costanti seguenti:

MCI_DGV_SETAUDIO_AVGBYTESPERSEC

Il numero medio di byte viene specificato nel membro dwValue della struttura identificata da lpSetAudio. Questo valore imposta il numero medio di byte al secondo per la riproduzione o la registrazione nei formati PCM (Pulse Code Modulation) e ADPCM (Adaptive Differential Pulse Code Modulation). Il file viene salvato in questo formato.

MCI_DGV_SETAUDIO_BASS

Il livello di bassa frequenza audio viene specificato come fattore nel membro dwValue della struttura identificata da lpSetAudio.

MCI_DGV_SETAUDIO_BITSPERSAMPLE

Il numero di bit per campione viene specificato nel membro dwValue della struttura identificata da lpSetAudio. Questo valore imposta il numero di bit per campione riprodotto o registrato nel formato PCM. Il file viene salvato in questo formato.

MCI_DGV_SETAUDIO_BLOCKALIGN

L'allineamento del blocco di dati viene specificato nel membro dwValue della struttura identificata da lpSetAudio. Questo valore imposta l'allineamento dei blocchi di dati rispetto all'inizio dei dati della forma d'onda di input.

MCI_DGV_SETAUDIO_SAMPLESPERSEC

La frequenza di campionamento viene specificata nel membro dwValue della struttura identificata da lpSetAudio. Questo valore imposta la frequenza di campionamento per la riproduzione e la registrazione con gli algoritmi PCM e ADPCM. Il file viene salvato in questo formato.

MCI_DGV_SETAUDIO_SOURCE

Una costante che specifica l'origine dell'input audio è inclusa nel membro dwValue della struttura identificata da lpSetAudio. Per le origini di input audio vengono definite le costanti seguenti:

MCI_DGV_SETAUDIO_SOURCE_AVERAGE

Media dei canali audio sinistro e destro.

MCI_DGV_SETAUDIO_SOURCE_LEFT

Canale audio sinistro.

MCI_DGV_SETAUDIO_SOURCE_RIGHT

Canale audio corretto.

MCI_DGV_SETAUDIO_SOURCE_STEREO

Stereo.

MCI_DGV_SETAUDIO_STREAM

Un flusso audio viene specificato nel membro dwValue della struttura identificata da lpSetAudio. Il valore intero specifica il flusso audio riprodotto dall'area di lavoro. Se il flusso non viene specificato, viene riprodotto il primo flusso audio fisicamente interleaved.

MCI_DGV_SETAUDIO_TREBLE

Il livello di frequenza elevata audio viene specificato come fattore nel membro dwValue della struttura identificata da lpSetAudio.

MCI_DGV_SETAUDIO_VOLUME

Il livello audio per uno o entrambi i canali audio viene specificato come fattore nel membro dwValue della struttura identificata da lpSetAudio. Se i volumi sinistro e destro sono stati impostati su valori diversi, il rapporto tra volume da sinistra a destra è approssimativamente invariato.

MCI_DGV_SETAUDIO_LEFT

Abilita il canale audio sinistro quando usato con MCI_SET_ON. Disabilita il canale audio sinistro quando usato con MCI_SET_OFF. Quando questo flag viene usato con la combinazione di MCI_DGV_SETAUDIO_VALUE e MCI_DGV_SETAUDIO_VOLUME, imposta il volume del canale audio sinistro. Quando questo flag viene usato con MCI_DGV_SETAUDIO_SOURCE, specifica il canale audio sinistro come origine per il digitalizzatore di input audio.

MCI_DGV_SETAUDIO_OVER

Un parametro di lunghezza della transizione è incluso nel membro dwOver della struttura identificata da lpSetAudio. Il valore di lunghezza specifica per quanto tempo (in unità di formato dell'ora corrente) deve essere necessario per apportare una modifica che usa un fattore. Se questo flag non viene usato, le modifiche vengono apportate immediatamente.

MCI_DGV_SETAUDIO_QUALITY

Il membro lpstrQuality della struttura identificata da lpSetAudio contiene un indirizzo di un buffer che definisce la qualità audio. Una stringa di testo all'interno del buffer specifica le caratteristiche dell'algoritmo di compressione audio.

Il flag MCI_DGV_SETAUDIO_ALG può essere usato per selezionare un descrittore di qualità per l'algoritmo specificato. Se questo flag viene omesso, viene usato l'algoritmo corrente.

Gli algoritmi e i nomi dei descrittori disponibili dipendono dal dispositivo. Ogni dispositivo fornisce la documentazione per gli algoritmi disponibili e una descrizione dei nomi dei descrittori applicabili. Il comando MCI_QUALITY può definire nomi di descrittori aggiuntivi.

MCI_DGV_SETAUDIO_RECORD

Specifica se la registrazione include o esclude i dati audio. In combinazione con MCI_SET_ON, i dati audio vengono registrati. In combinazione con MCI_SET_OFF, i dati audio vengono esclusi. Il valore predefinito include dati audio.

MCI_DGV_SETAUDIO_RIGHT

Abilita il canale audio corretto quando usato con MCI_SET_ON. Disabilita il canale audio corretto quando usato con MCI_SET_OFF. Quando questo flag viene usato con la combinazione di MCI_DGV_SETAUDIO_VALUE e MCI_DGV_SETAUDIO_VOLUME, imposta il volume del canale audio corretto.

MCI_DGV_SETAUDIO_VALUE

Un valore viene specificato nel membro dwValue della struttura identificata da lpSetAudio. Il significato del valore viene specificato dalla costante definita per il flag MCI_DGV_SETAUDIO_ITEM.

MCI_SET_OFF

Disabilita il canale audio specificato.

MCI_SET_ON

Abilita il canale audio specificato.

MCI_SETAUDIO_OUTPUT

Modifica il basso, treble o la bandiera del volume in modo che modifichi solo il segnale riprodotto e non ciò che viene registrato. Se possibile, si tratta dell'impostazione predefinita durante il monitoraggio dell'input.

Per i dispositivi digital-video, il parametro lpSetAudio punta a una struttura MCI_DGV_SETAUDIO_PARMS .

I flag aggiuntivi seguenti vengono usati con il tipo di dispositivo vcr :

MCI_VCR_SETAUDIO_RECORD

Imposta la registrazione audio su on o off, che viene utilizzata in combinazione con uno dei flag seguenti:

MCI_SET_ON

Registrazione audio attivata.

MCI_SET_OFF

Registrazione audio disattivata. Potrebbe essere necessario disattivare la registrazione di assemblaggio (usando il comando MCI_SET con il flag di MCI_VCR_SET_ASSEMBLE_RECORD impostato su disattivata) prima che la registrazione audio possa essere disattivata.

MCI_TRACK

Il membro dwTrack della struttura identificata da lpSetAudio specifica la traccia interessata dal comando.

MCI_VCR_SETAUDIO_SOURCE

Imposta l'origine audio. Questo flag deve essere usato con il flag MCI_VCR_SETAUDIO_TO.

MCI_VCR_SETAUDIO_MONITOR

Imposta il monitoraggio dell'origine audio. Questo flag deve essere usato con il flag MCI_VCR_SETAUDIO_TO.

MCI_VCR_SETAUDIO_TO

Il membro dwTo della struttura identificata da lpSetAudio contiene una costante che descrive il tipo di input o di input monitorato. Deve essere uno dei seguenti:

MCI_VCR_SRC_TYPE_TUNER

Il tipo è il tuner.

MCI_VCR_SRC_TYPE_LINE

Il tipo è line.

MCI_VCR_SRC_TYPE_AUX

Il tipo è ausiliario.

MCI_VCR_SRC_TYPE_GENERIC

Il tipo è generico.

MCI_VCR_SRC_TYPE_MUTE

Il tipo è disattivato. Può essere usato solo con il flag MCI_VCR_SETAUDIO_SOURCE.

MCI_VCR_SRC_TYPE_OUTPUT

Il tipo è l'output.

MCI_VCR_SETAUDIO_NUMBER

Il membro dwNumber della struttura identificata da lpSetAudio contiene l'input audio (del tipo specificato nel membro dwTo) da utilizzare.

Per i dispositivi VCR, il parametro lpSetAudio punta a una struttura MCI_VCR_SETAUDIO_PARMS .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Mmsystem.h (include Windows.h)

Vedi anche

MCI

Comandi MCI