função DRVM_MAPPER_CONSOLEVOICECOM_GET
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) |
Confira também
ID do dispositivo de Voice-Communications preferencial