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 |
|---|---|
|
Il riferimento al controllo non è valido. |
|
Il parametro hmxobj specifica un identificatore di dispositivo non valido. |
|
Uno o più flag non sono validi. |
|
Il parametro hmxobj specifica un handle non valido. |
|
Uno o più parametri non sono validi. |
|
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 |