funzione mixerGetControlDetailsA (mmeapi.h)

Articolo
11/20/2024

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

Sintassi

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

Parametri

hmxobj

Handle per l'oggetto dispositivo mixer sottoposto a query.

pmxcd

Puntatore a una struttura MIXERCONTROLDETAILS, che contiene informazioni sullo stato del controllo.

fdwDetails

Flag per il recupero dei dettagli del controllo. Vengono definiti i valori seguenti.

Valore	Significato
MIXER_GETCONTROLDETAILSF_LISTTEXT	Il paDetails membro della struttura MIXERCONTROLDETAILS di 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 utilizzato con i controlli MIXERCONTROL_CONTROLTYPE_CUSTOM.
MIXER_GETCONTROLDETAILSF_VALUE	I valori correnti per un controllo vengono recuperati. Il paDetails membro della struttura MIXERCONTROLDETAILS di punta a una o più strutture di dettagli appropriate per la classe di controllo.
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 (Musical Instrument Digital Interface). 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.
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

Prima di chiamare questa funzione, è necessario inizializzare tutti i membri della struttura MIXERCONTROLDETAILS.

Nota

L'intestazione mmeapi.h definisce mixerGetControlDetails 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 Mmeapi.h, Windows.h)
libreria	Winmm.lib
dll	Winmm.dll

Vedere anche

funzioni mixer audio

mixer audio

Condividi tramite