función DRVM_MAPPER_CONSOLEVOICECOM_GET
El mensaje DRVM_MAPPER_CONSOLEVOICECOM_GET recupera el identificador de dispositivo del dispositivo de comunicaciones de voz preferido.
Sintaxis
DWORD xxxMessage(
UINT uDeviceID,
UINT uMsg,
DWORD_PTR dwParam1,
DWORD_PTR dwParam2
);
Parámetros
uDeviceID
Especifica el identificador del dispositivo de destino. Consulte la sección Comentarios siguientes para obtener más información sobre cómo convertir este valor para su uso con la función adecuada.uMsg
El autor de la llamada establece este parámetro en DRVM_MAPPER_CONSOLEVOICECOM_GET cuando llama a xxxMessage para procesar este mensaje de dispositivo.dwParam1
Puntero al identificador de dispositivo. Este parámetro apunta a una variable DWORD en la que la función escribe el identificador de dispositivo del dispositivo de comunicaciones de voz preferido actual. La función escribe el valor (-1) si no hay ningún dispositivo disponible que se califica como un dispositivo de comunicaciones de voz preferido.dwParam2
Puntero a las marcas de estado. Este parámetro apunta a una variable DWORD en la que la función escribe las marcas de estado del dispositivo. Actualmente solo se define un bit de marca: DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
Valor devuelto
La función xxxMessage devuelve MMSYSERR_NOERROR si el mensaje se controla correctamente. De lo contrario, devuelve un código de error adecuado.
Comentarios
Este mensaje solo es válido para las funciones waveInMessage y waveOutMessage . Cuando un llamador llama a estas dos funciones con el mensaje DRVM_MAPPER_CONSOLEVOICECOM_GET, el autor de la llamada debe especificar el identificador de dispositivo como WAVE_MAPPER y, a continuación, convertir este valor en el tipo de identificador adecuado. Para las funciones waveInMessage, waveOutMessage, midiInMessage, midiOutMessage o mixerMessage, el llamador debe convertir el identificador del dispositivo a un identificador de tipo HWAVEIN, HWAVEOUT, HMIDIIN, HMIDIOUT o HMIXER, respectivamente. Tenga en cuenta que si el autor de la llamada proporciona un identificador válido en lugar de un identificador de dispositivo para este parámetro, la función produce un error y devuelve el código de error MMSYSERR_NOSUPPORT.
El sistema intercepta este mensaje y devuelve el valor adecuado sin enviar el mensaje al controlador del dispositivo. Para obtener información general sobre las funciones xxxMessage interceptadas por el sistema, consulte Mensajes de dispositivo interceptados por el sistema.
Este mensaje proporciona una manera de determinar qué dispositivo se prefiere específicamente para las comunicaciones de voz, a diferencia del mensaje de DRVM_MAPPER_PREFERRED_GET , que determina qué dispositivo se prefiere para todas las demás funciones de audio.
Por ejemplo, el dispositivo waveOut preferido para las comunicaciones de voz podría ser el auricular en un casco, pero el dispositivo waveOut preferido para todas las demás funciones de audio podría ser un conjunto de altavoces estéreo.
Cuando el bit de marca de DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY se establece en la ubicación DWORD a la que apunta dwParam2, las API waveIn y waveOut solo usan el dispositivo de comunicaciones de voz preferido actual y no buscan otros dispositivos disponibles si el dispositivo preferido no está disponible. La marca que genera la llamada waveInMessage o waveOutMessage se aplica al dispositivo preferido de comunicaciones de voz para las API waveIn y waveOut , independientemente de si la llamada se realiza a waveInMessage o waveOutMessage. Para obtener más información, consulte Id. de dispositivo Voice-Communications preferido.
Requisitos
Plataforma de destino |
Escritorio |
Versión |
Compatible con los sistemas operativos Microsoft Windows Me y Windows 2000 y versiones posteriores. |
Encabezado |
Mmddk.h (incluye Mmddk.h) |
Consulte también
Id. de dispositivo de Voice-Communications preferido