Função mixerGetID (mmeapi.h)

Artigo
08/24/2023

A função mixerGetID recupera o identificador de dispositivo para um dispositivo de mixer associado a um identificador de dispositivo especificado.

Sintaxe

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

Parâmetros

hmxobj

Manipule para o objeto do mixer de áudio a ser mapeado para um identificador de dispositivo de mixer.

puMxId

Ponteiro para uma variável que recebe o identificador de dispositivo do mixer. Se nenhum dispositivo de mixer estiver disponível para o objeto hmxobj , o valor -1 será colocado nesse local e o valor de erro MMSYSERR_NODRIVER será retornado.

fdwId

Sinalizadores para mapear o objeto do mixer hmxobj. Os valores a seguir são definidos.

Valor	Significado
MIXER_OBJECTF_AUX	O parâmetro hmxobj é um identificador de dispositivo auxiliar no intervalo de zero a um a menos do que o número de dispositivos retornados pela função auxGetNumDevs .
MIXER_OBJECTF_HMIDIIN	O parâmetro hmxobj é o identificador de um dispositivo de entrada MIDI. Esse identificador deve ter sido retornado pela função midiInOpen .
MIXER_OBJECTF_HMIDIOUT	O parâmetro hmxobj é o identificador de um dispositivo de saída MIDI. Esse identificador deve ter sido retornado pela função midiOutOpen .
MIXER_OBJECTF_HMIXER	O parâmetro hmxobj é um identificador de dispositivo de mixer retornado pela função mixerOpen . Esse sinalizador é opcional.
MIXER_OBJECTF_HWAVEIN	O parâmetro hmxobj é um identificador de entrada waveform-audio retornado pela função waveInOpen .
MIXER_OBJECTF_HWAVEOUT	O parâmetro hmxobj é um identificador de saída waveform-audio retornado pela função waveOutOpen .
MIXER_OBJECTF_MIDIIN	O parâmetro hmxobj é o identificador de um dispositivo de entrada MIDI. Esse identificador deve estar no intervalo de zero a um menor que o número de dispositivos retornados pela função midiInGetNumDevs .
MIXER_OBJECTF_MIDIOUT	O parâmetro hmxobj é o identificador de um dispositivo de saída MIDI. Esse identificador deve estar no intervalo de zero a um menor que o número de dispositivos retornados pela função midiOutGetNumDevs .
MIXER_OBJECTF_MIXER	O parâmetro hmxobj é o identificador de um dispositivo de mixer no intervalo de zero a um menor que o número de dispositivos retornados pela função mixerGetNumDevs . Esse sinalizador é opcional.
MIXER_OBJECTF_WAVEIN	O parâmetro hmxobj é o identificador de um dispositivo de entrada waveform-audio no intervalo de zero a um a menos do que o número de dispositivos retornados pela função waveInGetNumDevs .
MIXER_OBJECTF_WAVEOUT	O parâmetro hmxobj é o identificador de um dispositivo de saída waveform-audio no intervalo de zero a um a menos do que o número de dispositivos retornados pela função waveOutGetNumDevs .

Retornar valor

Retorna MMSYSERR_NOERROR se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte.

Código de retorno	Descrição
MMSYSERR_BADDEVICEID	O parâmetro hmxobj especifica um identificador de dispositivo inválido.
MMSYSERR_INVALFLAG	Um ou mais sinalizadores são inválidos.
MMSYSERR_INVALHANDLE	O parâmetro hmxobj especifica um identificador inválido.
MMSYSERR_INVALPARAM	Um ou mais parâmetros são inválidos.
MMSYSERR_NODRIVER	Nenhum dispositivo de mixer de áudio está disponível para o objeto especificado por hmxobj. O local referenciado por puMxId também contém o valor -1.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mmeapi.h (inclua Windows.h)
Biblioteca	Winmm.lib
DLL	Winmm.dll

Confira também

Funções de mixer de áudio

Combinadores de áudio

Compartilhar via