funzione mixerGetControlDetails (mmeapi.h)

Articolo
08/24/2023

La funzione mixerGetControlDetails recupera i dettagli relativi a un singolo controllo associato a una linea audio.

Sintassi

MMRESULT mixerGetControlDetails(
  HMIXEROBJ             hmxobj,
  LPMIXERCONTROLDETAILS pmxcd,
  DWORD                 fdwDetails
);

Parametri

hmxobj

Gestire l'oggetto del dispositivo mixer sottoposto a query.

pmxcd

Puntatore a una struttura MIXERCONTROLDETAILS , che viene riempita con informazioni sullo stato sul controllo.

fdwDetails

Flag per il recupero dei dettagli del controllo. I valori seguenti sono definiti.

Valore	Significato
MIXER_GETCONTROLDETAILSF_LISTTEXT	Il membro paDetails della struttura MIXERCONTROLDETAILS punta a una o più strutture MIXERCONTROLDETAILS_LISTTEXT per ricevere etichette di testo per i controlli a più elementi. Un'applicazione deve ottenere tutti gli elementi di testo dell'elenco per un controllo a più elementi contemporaneamente. Questo flag non può essere usato con controlli MIXERCONTROL_CONTROLTYPE_CUSTOM.
MIXER_GETCONTROLDETAILSF_VALUE	I valori correnti per un controllo vengono recuperati. Il membro paDetails della struttura MIXERCONTROLDETAILS punta a una o più strutture dettagliate appropriate per la classe di controllo.
MIXER_OBJECTF_AUX	Il parametro hmxobj è un identificatore di dispositivo ausiliario nell'intervallo di zero a uno inferiore al numero di dispositivi restituiti dalla funzione auxGetNumDevs .
MIXER_OBJECTF_HMIDIIN	Il parametro hmxobj è l'handle di un dispositivo di input MIDI (Musical Instrument Digital Interface). 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 waveform-audio restituito dalla funzione waveInOpen .
MIXER_OBJECTF_HWAVEOUT	Il parametro hmxobj è un handle di output waveform-audio restituito dalla funzione waveOutOpen .
MIXER_OBJECTF_MIDIIN	Il parametro hmxobj è l'identificatore di un dispositivo di input MIDI. Questo identificatore deve trovarsi nell'intervallo di zero a uno inferiore al 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 di zero a uno inferiore al numero di dispositivi restituiti dalla funzione midiOutGetNumDevs .
MIXER_OBJECTF_MIXER	Il parametro hmxobj è l'identificatore di un dispositivo mixer nell'intervallo di zero a uno inferiore al numero di dispositivi restituiti dalla funzione mixerGetNumDevs . Questo flag è facoltativo.
MIXER_OBJECTF_WAVEIN	Il parametro hmxobj è l'identificatore di un dispositivo di input waveform-audio nell'intervallo di zero a uno inferiore al numero di dispositivi restituiti dalla funzione waveInGetNumDevs .
MIXER_OBJECTF_WAVEOUT	Il parametro hmxobj è l'identificatore di un dispositivo di output waveform-audio nell'intervallo di zero a uno inferiore al numero di dispositivi restituiti dalla funzione waveOutGetNumDevs .

Valore restituito

Restituisce MMSYSERR_NOERROR se ha 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.
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.

Commenti

Tutti i membri della struttura MIXERCONTROLDETAILS devono essere inizializzati prima di chiamare questa funzione.

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 Mmeapi.h, Windows.h)
Libreria	Winmm.lib
DLL	Winmm.dll

Vedi anche

Funzioni del mixer audio

Mixer audio

Share via