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
);
-
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.
Restituisce zero se l'operazione ha esito positivo o un errore in caso contrario.
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 .
Requisito | Valore |
---|---|
Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
Server minimo supportato |
Windows 2000 Server [solo app desktop] |
Intestazione |
|