Funzione mixerGetID (mmeapi.h)

Articolo
03/15/2023

La funzione mixerGetID recupera l'identificatore del dispositivo per un dispositivo mixer associato a un handle di dispositivo specificato.

Sintassi

MMRESULT mixerGetID(
  HMIXEROBJ hmxobj,
  UINT      *puMxId,
  DWORD     fdwId
);

Parametri

hmxobj

Handle per l'oggetto mixer audio da mappare a un identificatore del dispositivo mixer.

puMxId

Puntatore a una variabile che riceve l'identificatore del dispositivo mixer. Se non è disponibile alcun dispositivo mixer per l'oggetto hmxobj , il valore -1 viene inserito in questa posizione e viene restituito il valore di errore MMSYSERR_NODRIVER.

fdwId

Flag per il mapping dell'oggetto mixer hmxobj. Vengono definiti i valori seguenti.

Valore	Significato
MIXER_OBJECTF_AUX	Il parametro hmxobj è un identificatore di dispositivo ausiliario compreso nell'intervallo da zero a uno minore del 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 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 se l'esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.

Codice restituito	Descrizione
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 audio è disponibile per l'oggetto specificato da hmxobj. La posizione a cui fa riferimento puMxId contiene anche il valore -1.

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

Vedi anche

Funzioni mixer audio

Mixer audio

Share via