funzione mixerGetLineControls (mmeapi.h)
La funzione mixerGetLineControls recupera uno o più controlli associati a una linea audio.
Sintassi
MMRESULT mixerGetLineControls(
HMIXEROBJ hmxobj,
LPMIXERLINECONTROLS pmxlc,
DWORD fdwControls
);
Parametri
hmxobj
Handle per l'oggetto dispositivo mixer su cui viene eseguita una query.
pmxlc
Puntatore a una struttura MIXERLINECONTROLS . Questa struttura viene utilizzata per fare riferimento a una o più strutture MIXERCONTROL da riempire con informazioni sui controlli associati a una linea audio. Il membro cbStruct della struttura MIXERLINECONTROLS deve essere sempre inizializzato in byte della struttura MIXERLINECONTROLS .
fdwControls
Flag per il recupero di informazioni su uno o più controlli associati a una linea audio. Vengono definiti i valori seguenti.
| Valore | Significato |
|---|---|
| MIXER_GETLINECONTROLSF_ALL | Il parametro pmxlc fa riferimento a un elenco di strutture MIXERCONTROL che riceveranno informazioni su tutti i controlli associati alla linea audio identificata dal membro dwLineID della struttura MIXERLINECONTROLS . Il membro cControls deve essere inizializzato al numero di controlli associati alla riga. Questo numero viene recuperato dal membro cControls della struttura MIXERLINE restituita dalla funzione mixerGetLineInfo . Il membro cbmxctrl deve essere inizializzato per le dimensioni, in byte, di una singola struttura MIXERCONTROL . Il membro pamxctrl deve puntare alla prima struttura MIXERCONTROL da riempire. I membri dwControlID e dwControlType vengono ignorati per questa query. |
| MIXER_GETLINECONTROLSF_ONEBYID | Il parametro pmxlc fa riferimento a una singola struttura MIXERCONTROL che riceverà informazioni sul controllo identificato dal membro dwControlID della struttura MIXERLINECONTROLS . Il membro cControls deve essere inizializzato su 1. Il membro cbmxctrl deve essere inizializzato per le dimensioni, in byte, di una singola struttura MIXERCONTROL . Il membro pamxctrl deve puntare a una struttura MIXERCONTROL da riempire. I membri dwLineID e dwControlType vengono ignorati per questa query. Questa query viene in genere usata per aggiornare un controllo dopo aver ricevuto un messaggio di notifica di modifica del controllo MM_MIXM_CONTROL_CHANGE dal callback definito dall'utente (vedere mixerOpen). |
| MIXER_GETLINECONTROLSF_ONEBYTYPE | La funzione mixerGetLineControls recupera informazioni sul primo controllo di una classe specifica per la linea audio su cui viene eseguita una query. Il parametro pmxlc fa riferimento a una singola struttura MIXERCONTROL che riceverà informazioni sul controllo specifico. La linea audio è identificata dal membro dwLineID . La classe del controllo viene specificata nel membro dwControlType della struttura MIXERLINECONTROLS . Il membro dwControlID viene ignorato per questa query. Questa query può essere usata da un'applicazione per ottenere informazioni su un singolo controllo associato a una riga. Ad esempio, è possibile che l'applicazione usi un misuratore di picco solo da una linea di output audio waveform. |
| MIXER_OBJECTF_AUX | Il parametro hmxobj è un identificatore di dispositivo ausiliario compreso nell'intervallo da zero a uno minore del numero di dispositivi restituiti dalla funzione auxGetNumDevs . |
| MIXER_OBJECTF_HMIDIIN | Il parametro hmxobj è l'handle di un dispositivo di input MIDI. Questo handle deve essere stato restituito dalla funzione midiInOpen . |
| MIXER_OBJECTF_HMIDIOUT | Il parametro hmxobj è l'handle di un dispositivo di output MIDI. Questo handle deve essere stato restituito dalla funzione midiOutOpen . |
| MIXER_OBJECTF_HMIXER | Il parametro hmxobj è un handle del dispositivo mixer restituito dalla funzione mixerOpen . Questo flag è facoltativo. |
| MIXER_OBJECTF_HWAVEIN | Il parametro hmxobj è un handle di input audio waveform restituito dalla funzione waveInOpen . |
| MIXER_OBJECTF_HWAVEOUT | Il parametro hmxobj è un handle di output audio waveform restituito dalla funzione waveOutOpen . |
| MIXER_OBJECTF_MIDIIN | Il parametro hmxobj è l'identificatore di un dispositivo di input MIDI. Questo identificatore deve essere compreso nell'intervallo da zero a uno minore del numero di dispositivi restituiti dalla funzione midiInGetNumDevs . |
| MIXER_OBJECTF_MIDIOUT | Il parametro hmxobj è l'identificatore di un dispositivo di output MIDI. Questo identificatore deve essere compreso nell'intervallo da zero a uno minore del numero di dispositivi restituiti dalla funzione midiOutGetNumDevs . |
| MIXER_OBJECTF_MIXER | Il parametro hmxobj è l'identificatore di un dispositivo mixer compreso nell'intervallo da zero a uno minore del numero di dispositivi restituiti dalla funzione mixerGetNumDevs . Questo flag è facoltativo. |
| MIXER_OBJECTF_WAVEIN | Il parametro hmxobj è l'identificatore di un dispositivo di input audio waveform nell'intervallo da zero a uno minore del numero di dispositivi restituiti dalla funzione waveInGetNumDevs . |
| MIXER_OBJECTF_WAVEOUT | Il parametro hmxobj è l'identificatore di un dispositivo di output audio waveform nell'intervallo da zero a uno minore del numero di dispositivi restituiti dalla funzione waveOutGetNumDevs . |
Valore restituito
Restituisce MMSYSERR_NOERROR se l'esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.
| Codice restituito | Descrizione |
|---|---|
|
Il riferimento al controllo non è valido. |
|
Il riferimento alla riga audio non è valido. |
|
Il parametro hmxobj specifica un identificatore di dispositivo non valido. |
|
Uno o più flag non sono validi. |
|
Il parametro hmxobj specifica un handle non valido. |
|
Uno o più parametri non sono validi. |
|
Nessun dispositivo mixer è disponibile per l'oggetto specificato da hmxobj. |
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | mmeapi.h (include Windows.h) |
| Libreria | Winmm.lib |
| DLL | Winmm.dll |