funzione mixerGetLineControlsA (mmeapi.h)

Articolo
11/20/2024

La funzione mixerGetLineControls recupera uno o più controlli associati a una linea audio.

Sintassi

MMRESULT mixerGetLineControlsA(
  HMIXEROBJ            hmxobj,
  LPMIXERLINECONTROLSA 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 per il 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 in byte di una singola struttura MIXERCONTROL. Il membro pamxctrl deve puntare alla prima struttura MIXERCONTROL da riempire. I dwControlID e dwControlType membri 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 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 di 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 del dispositivo ausiliario compreso nell'intervallo da zero a uno minore del numero di dispositivi restituiti dal funzione auxGetNumDevs.
MIXER_OBJECTF_HMIDIIN	Il parametro hmxobj è l'handle di un dispositivo di input MIDI. Questa maniglia deve essere stata restituita 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 in caso di esito positivo o di errore. I possibili valori di errore 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.

Osservazioni

Nota

L'intestazione mmeapi.h definisce mixerGetLineControls come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	mmeapi.h (include Windows.h)
libreria	Winmm.lib
dll	Winmm.dll

Vedere anche

funzioni mixer audio

mixer audio

Condividi tramite