funzione mixerSetControlDetails (mmeapi.h)

La funzione mixerSetControlDetails imposta le proprietà di un singolo controllo associato a una linea audio.

Sintassi

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

Parametri

hmxobj

Handle all'oggetto dispositivo mixer per cui vengono impostate le proprietà.

pmxcd

Puntatore a una struttura MIXERCONTROLDETAILS . Questa struttura viene usata per fare riferimento alle strutture dei dettagli del controllo che contengono lo stato desiderato per il controllo.

fdwDetails

Flag per l'impostazione delle proprietà per un controllo. I valori seguenti sono definiti.

Valore	Significato
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. 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 è un identificatore di 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 .
MIXER_SETCONTROLDETAILSF_CUSTOM	Viene visualizzata una finestra di dialogo personalizzata per il controllo mixer personalizzato specificato. Il dispositivo mixer raccoglie le informazioni necessarie dall'utente e restituisce i dati nel buffer specificato. L'handle per la finestra di proprietà viene specificato nel membro hwndOwner della struttura MIXERCONTROLDETAILS . Questo handle può essere impostato su NULL. L'applicazione può quindi salvare i dati dalla finestra di dialogo e usarla in un secondo momento per reimpostare il controllo nello stesso stato usando il flag MIXER_SETCONTROLDETAILSF_VALUE.
MIXER_SETCONTROLDETAILSF_VALUE	I valori correnti per un controllo sono impostati. Il membro paDetails della struttura MIXERCONTROLDETAILS punta a una o più strutture di dettagli del controllo mixer della classe appropriata per il controllo.

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 mixerSetControlDetails.

Se un'applicazione deve recuperare solo lo stato corrente di un controllo mixer personalizzato e non visualizzare una finestra di dialogo, è possibile usare mixerGetControlDetails con il flag di MIXER_GETCONTROLDETAILSF_VALUE.

Requisiti

Requisito	Valore
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 (includere Windows.h)
Libreria	Winmm.lib
DLL	Winmm.dll

Vedi anche

Funzioni del mixer audio

Mixer audio