função DRVM_MAPPER_CONSOLEVOICECOM_GET

Artigo
03/08/2023

A mensagem DRVM_MAPPER_CONSOLEVOICECOM_GET recupera a ID do dispositivo do dispositivo de comunicação de voz preferencial.

Sintaxe

DWORD  xxxMessage(
   UINT      uDeviceID,
   UINT      uMsg,
   DWORD_PTR dwParam1,
   DWORD_PTR dwParam2
);

Parâmetros

Udeviceid
Especifica a ID do dispositivo de destino. Consulte a seção Comentários a seguir para obter mais informações sobre como converter esse valor para uso com a função apropriada.
uMsg
O chamador define esse parâmetro como DRVM_MAPPER_CONSOLEVOICECOM_GET quando chama xxxMessage para processar essa mensagem de dispositivo.
Dwparam1
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.
Dwparam2
Ponteiro para sinalizadores de status. Esse parâmetro aponta para uma variável DWORD na qual a função grava os sinalizadores status dispositivo. No momento, apenas um bit de sinalizador está definido: DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY. Para obter mais informações, consulte a seção Comentários a seguir.

Retornar valor

A função xxxMessage retornará MMSYSERR_NOERROR se a mensagem for tratada com êxito. Caso contrário, ele retornará um código de erro apropriado.

Comentários

Essa mensagem é válida apenas 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 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 especificamente para comunicações de voz, ao contrário da mensagem DRVM_MAPPER_PREFERRED_GET , que determina qual dispositivo é preferencial para todas as outras funções de áudio.

Por exemplo, o dispositivo waveOut preferido para comunicações de voz pode ser o fone de ouvido em um fone de ouvido, mas o dispositivo waveOut preferido 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 gerado pela chamada waveInMessage ou waveOutMessage se aplica 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.

Requisitos

Plataforma de destino	Área de Trabalho
Versão	Com suporte nos sistemas operacionais Microsoft Windows Me e Windows 2000 e posterior.
parâmetro	Mmddk.h (inclua Mmddk.h)