Função mixerMessage (mmeapi.h)
A função mixerMessage envia uma mensagem de driver de mixer personalizada diretamente para um driver de mixer.
Sintaxe
DWORD mixerMessage(
HMIXER hmx,
UINT uMsg,
DWORD_PTR dwParam1,
DWORD_PTR dwParam2
);
Parâmetros
hmx
Identificador do mixer que recebe a mensagem. Você deve converter a ID do dispositivo no tipo de identificador HMIXER . Se você fornecer um identificador em vez de uma ID de dispositivo, a função falhará e retornará o código de erro MMSYSERR_NOSUPPORT.
uMsg
Mensagem de driver do mixer personalizado a ser enviada para o driver do mixer. Essa mensagem deve estar acima ou igual à constante MXDM_USER.
dwParam1
Parâmetro associado à mensagem que está sendo enviada.
dwParam2
Parâmetro associado à mensagem que está sendo enviada.
Valor retornado
Retorna um valor específico para a mensagem de driver do mixer personalizado. Os valores de erro possíveis incluem o seguinte.
| Código de retorno | Descrição |
|---|---|
|
O identificador de dispositivo especificado é inválido. |
|
O parâmetro uMsg especificado na mensagem MXDM_USER é inválido. |
|
O parâmetro deviceID deve ser uma ID de dispositivo válida. |
|
O dispositivo de mixer não processou a mensagem. |
Comentários
As mensagens definidas pelo usuário devem ser enviadas somente para um driver de mixer que dê suporte às mensagens. O aplicativo deve verificar se o driver do mixer é o driver que dá suporte à mensagem recuperando os recursos do mixer e verificando os membros wMid, wPid, vDriverVersion e szPname da estrutura MIXERCAPS .
A DRV_QUERYDEVICEINTERFACE mensagem consulta o nome da interface do dispositivo de um dispositivo waveIn, waveOut, midiIn, midiOut ou mixer .
Para DRV_QUERYDEVICEINTERFACE, dwParam1 é um ponteiro para um buffer alocado pelo chamador no qual a função grava uma cadeia de caracteres Unicode terminada em nulo que contém o nome da interface do dispositivo. Se o dispositivo não tiver interface do dispositivo, o comprimento da cadeia de caracteres será zero.
Para DRV_QUERYDEVICEINTERFACE, dwParam2 especifica o tamanho do buffer em bytes. Esse é um parâmetro de entrada para a função . O chamador deve especificar um tamanho maior ou igual ao tamanho do buffer recuperado pela mensagem DRV_QUERYDEVICEINTERFACESIZE .
Há suporte para a mensagem DRV_QUERYDEVICEINTERFACE no Windows Me e no Windows 2000 e posterior. Essa mensagem é válida apenas para as funções waveInMessage, waveOutMessage, midiInMessage, midiOutMessage e mixerMessage . O sistema intercepta essa mensagem e retorna o valor apropriado sem enviar a mensagem para o driver de dispositivo. Para obter informações gerais sobre funções xxxMessage interceptadas pelo sistema, consulte Mensagens de dispositivo interceptadas pelo sistema.
As duas constantes de mensagem a seguir são usadas juntas para obter nomes de interface do dispositivo:
- DRV_QUERYDEVICEINTERFACESIZE
- DRV_QUERYDEVICEINTERFACE
Para obter mais informações, consulte Obtendo um nome de interface do dispositivo.
A DRV_QUERYDEVICEINTERFACESIZE mensagem consulta o tamanho do buffer necessário para manter o nome da interface do dispositivo.
Para DRV_QUERYDEVICEINTERFACESIZE, dwParam1 é um ponteiro para o tamanho do buffer. Esse parâmetro aponta para uma variável ULONG na qual a função grava o tamanho do buffer necessário em bytes. O tamanho inclui espaço de armazenamento para o nulo de terminação da cadeia de caracteres de nome. O tamanho será zero se a ID do dispositivo identificar um dispositivo que não tenha interface do dispositivo.
Para DRV_QUERYDEVICEINTERFACESIZE, dwParam2 não é usado. Defina esse parâmetro como zero.
Essa mensagem é válida apenas para as funções waveInMessage, waveOutMessage, midiInMessage, midiOutMessage e mixerMessage . O sistema intercepta essa mensagem e retorna o valor apropriado sem enviar a mensagem para o driver de dispositivo. Para obter informações gerais sobre funções xxxMessage interceptadas pelo sistema, consulte Mensagens de dispositivo interceptadas pelo sistema.
O tamanho do buffer recuperado por essa mensagem é expresso como uma contagem de bytes. Ele especifica o tamanho do buffer necessário para manter a cadeia de caracteres Unicode terminada em nulo que contém o nome da interface do dispositivo. O chamador aloca um buffer do tamanho especificado e usa a mensagem DRV_QUERYDEVICEINTERFACE para recuperar a cadeia de caracteres de nome da interface do dispositivo.
Para obter mais informações, consulte Obtendo um nome de interface do dispositivo.
A DRV_QUERYDEVNODE mensagem consulta o número do devnode atribuído ao dispositivo pelo gerenciador do Plug and Play.
Para DRV_QUERYDEVNODE, dwParam1 é um ponteiro para uma variável DWORD alocada pelo chamador na qual a função grava o número do devnode. Se nenhum devnode for atribuído ao dispositivo, a função definirá essa variável como zero.
Para DRV_QUERYDEVNODE, dwParam2 não é usado. Defina esse parâmetro como zero.
No Windows 2000 e posterior, a mensagem sempre retorna MMSYSERR_NOTSUPPORTED. Essa mensagem é válida apenas para as funções waveInMessage, waveOutMessage, midiInMessage, midiOutMessage e mixerMessage . O sistema intercepta essa mensagem e retorna o valor apropriado sem enviar a mensagem para o driver de dispositivo. Para obter informações gerais sobre funções xxxMessage interceptadas pelo sistema, consulte Mensagens de dispositivo interceptadas pelo sistema.
A DRV_QUERYMAPPABLE mensagem consulta se o dispositivo especificado pode ser usado por um mapeador.
Para DRV_QUERYMAPPABLE, dwParam1 não é usado. Defina esse parâmetro como zero.
Para DRV_QUERYMAPPABLE, dwParam2 não é usado. Defina esse parâmetro como zero.
Essa mensagem é válida apenas para as funções waveInMessage, waveOutMessage, midiInMessage, midiOutMessage, mixerMessage e auxOutMessage . O sistema intercepta essa mensagem e retorna o valor apropriado sem enviar a mensagem para o driver de dispositivo. Para obter informações gerais sobre funções xxxMessage interceptadas pelo sistema, consulte Mensagens de dispositivo interceptadas pelo sistema.
Quando um programa de aplicativo abre um mapeador em vez de um dispositivo de áudio específico, o sistema insere um mapeador entre o aplicativo e os dispositivos disponíveis. O mapeador seleciona um dispositivo apropriado mapeando os requisitos do aplicativo para um dos dispositivos disponíveis. Para obter mais informações sobre mapeados, consulte a documentação do SDK do Microsoft Windows.
A DRVM_MAPPER_CONSOLEVOICECOM_GET mensagem recupera a ID do dispositivo de comunicação de voz preferencial.
Para DRVM_MAPPER_CONSOLEVOICECOM_GET, dwParam1 é um ponteiro para a ID do dispositivo. Esse parâmetro aponta para uma variável DWORD na qual a função grava a ID do dispositivo de comunicação de voz preferencial atual. A função gravará o valor (-1) se nenhum dispositivo estiver disponível que se qualifique como um dispositivo de comunicação de voz preferencial.
Para DRVM_MAPPER_CONSOLEVOICECOM_GET, dwParam2 é um ponteiro para status sinalizadores. Esse parâmetro aponta para uma variável DWORD na qual a função grava os sinalizadores status dispositivo. Apenas um bit de sinalizador está definido no momento: DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY.
Essa mensagem é válida somente para as funções waveInMessage e waveOutMessage . Quando um chamador chama essas duas funções com a mensagem DRVM_MAPPER_CONSOLEVOICECOM_GET, o chamador deve especificar a ID do dispositivo como WAVE_MAPPER e, em seguida, converter esse valor para o tipo de identificador apropriado. Para as funções waveInMessage, waveOutMessage, midiInMessage, midiOutMessage ou mixerMessage , o chamador deve converter a ID do dispositivo em um identificador do tipo HWAVEIN, HWAVEOUT, HMIDIIN, HMIDIOUT ou HMIXER, respectivamente. Observe que, se o chamador fornecer um identificador válido em vez de uma ID de dispositivo para esse parâmetro, a função falhará e retornará o código de erro MMSYSERR_NOSUPPORT.
O sistema intercepta essa mensagem e retorna o valor apropriado sem enviar a mensagem para o driver de dispositivo. Para obter informações gerais sobre funções xxxMessage interceptadas pelo sistema, consulte Mensagens de dispositivo interceptadas pelo sistema.
Essa mensagem fornece uma maneira de determinar qual dispositivo é preferencial especificamente para comunicações de voz, em contraste com a mensagem DRVM_MAPPER_PREFERRED_GET , que determina qual dispositivo é preferencial para todas as outras funções de áudio.
Por exemplo, o dispositivo waveOut preferencial para comunicações de voz pode ser o fone de ouvido em um fone de ouvido, mas o dispositivo waveOut preferencial para todas as outras funções de áudio pode ser um conjunto de alto-falantes estéreo.
Quando o bit do sinalizador DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY é definido no local DWORD apontado por dwParam2, as APIs waveIn e waveOut usam apenas o dispositivo de comunicação de voz preferencial atual e não pesquisam outros dispositivos disponíveis se o dispositivo preferencial não estiver disponível. O sinalizador que é gerado pela chamada waveInMessage ou waveOutMessage aplica-se ao dispositivo de comunicação de voz preferencial para as APIs waveIn e waveOut , independentemente de a chamada ser feita para waveInMessage ou waveOutMessage. Para obter mais informações, consulte Preferred Voice-Communications Device ID.
A DRVM_MAPPER_PREFERRED_GET mensagem recupera a ID do dispositivo de áudio preferencial.
Para DRVM_MAPPER_PREFERRED_GET, dwParam1 é um ponteiro para a ID do dispositivo. Esse parâmetro aponta para uma variável DWORD na qual a função grava a ID do dispositivo preferencial atual. A função gravará o valor (-1) se nenhum dispositivo estiver disponível que se qualifique como um dispositivo preferencial.
Para DRVM_MAPPER_PREFERRED_GET, dwParam2 é um ponteiro para status sinalizadores. Esse parâmetro aponta para uma variável DWORD na qual a função grava os sinalizadores status dispositivo. Apenas um bit de sinalizador está definido no momento (somente para chamadas waveInMessage e waveOutMessage ): DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY.
Essa mensagem é válida apenas para as funções waveInMessage, waveOutMessage e midiOutMessage . Quando o chamador chama essas funções com a mensagem DRVM_MAPPER_PREFERRED_GET, o chamador deve primeiro especificar a ID do dispositivo como WAVE_MAPPER (para waveInMessage ou waveOutMessage) ou MIDI_MAPPER (para midiOutMessage) e, em seguida, converter esse valor para o tipo de identificador apropriado. Para as funções waveInMessage, waveOutMessage ou midiOutMessage , o chamador deve converter a ID do dispositivo em um tipo de identificador HWAVEIN, HWAVEOUT ou HMIDIOUT, respectivamente. Observe que, se o chamador fornecer um identificador válido em vez de uma ID de dispositivo para esse parâmetro, a função falhará e retornará o código de erro MMSYSERR_NOSUPPORT.
O sistema intercepta essa mensagem e retorna o valor apropriado sem enviar a mensagem para o driver do dispositivo. Para obter informações gerais sobre funções xxxMessage interceptadas pelo sistema, consulte Mensagens de dispositivo interceptadas pelo sistema.
Essa mensagem fornece uma maneira de determinar qual dispositivo é preferido para funções de áudio em geral, ao contrário da mensagem DRVM_MAPPER_CONSOLEVOICECOM_GET , que determina qual dispositivo é preferido especificamente para comunicações de voz.
Quando o bit do sinalizador DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY é definido no local DWORD apontado por dwParam2, as APIs waveIn e waveOut usam apenas o dispositivo preferencial atual e não pesquisam outros dispositivos disponíveis se o dispositivo preferencial não estiver disponível. Observe que a função midiOutMessage não gera esse sinalizador — a API midiOut sempre usa apenas o dispositivo preferencial. O sinalizador gerado pela chamada waveInMessage ou waveOutMessage se aplica ao dispositivo preferencial para as APIs waveIn e waveOut , independentemente de a chamada ser feita para waveInMessage ou waveOutMessage.
As funções xxxMessage aceitam esse valor no lugar de um identificador de dispositivo válido para permitir que um aplicativo determine a ID do dispositivo padrão sem primeiro precisar abrir um dispositivo. Para obter mais informações, consulte Acessando a ID do dispositivo preferencial.
Requisitos
| 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 |