funzione mixerGetControlDetails (mmeapi.h)
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 |
|---|---|
|
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 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 |