funzione mixerGetLineControls (mmeapi.h)

Articolo
08/24/2023

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
MIXERR_INVALCONTROL	Il riferimento al controllo non è valido.
MIXERR_INVALLINE	Il riferimento alla riga audio non è valido.
MMSYSERR_BADDEVICEID	Il parametro hmxobj specifica un identificatore di dispositivo non valido.
MMSYSERR_INVALFLAG	Uno o più flag non sono validi.
MMSYSERR_INVALHANDLE	Il parametro hmxobj specifica un handle non valido.
MMSYSERR_INVALPARAM	Uno o più parametri non sono validi.
MMSYSERR_NODRIVER	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

Vedi anche

Funzioni mixer audio

Mixer audio

Share via