DRVM_MAPPER_PREFERRED_GET función

Artículo
03/08/2023

El mensaje DRVM_MAPPER_PREFERRED_GET recupera el identificador de dispositivo del dispositivo de audio 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 siguiente sección Comentarios para obtener más información sobre cómo convertir este valor para su uso con la función adecuada.
uMsg
El llamador establece este parámetro en DRVM_MAPPER_PREFERRED_GET cuando llama a xxxMessage para procesar este mensaje de dispositivo.
dwParam1
Puntero al identificador del dispositivo. Este parámetro apunta a una variable DWORD en la que la función escribe el identificador de dispositivo del dispositivo preferido actual. La función escribe el valor (-1) si no hay ningún dispositivo disponible que se califica como dispositivo 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 (solo para waveInMessage y waveOutMessage ): 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, waveOutMessage y midiOutMessage . Cuando el llamador llama a estas funciones con el mensaje DRVM_MAPPER_PREFERRED_GET, el autor de la llamada debe especificar primero el identificador de dispositivo como WAVE_MAPPER (para waveInMessage o waveOutMessage) o MIDI_MAPPER (para midiOutMessage) y, a continuación, convertir este valor en el tipo de identificador adecuado. Para las funciones waveInMessage, waveOutMessage o midiOutMessage , el autor de la llamada debe convertir el identificador del dispositivo en un tipo de identificador HWAVEIN, HWAVEOUT o HMIDIOUT, 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 para las funciones de audio en general, a diferencia del mensaje de DRVM_MAPPER_CONSOLEVOICECOM_GET , que determina qué dispositivo se prefiere específicamente para las comunicaciones de voz.

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 preferido actual y no buscan otros dispositivos disponibles si el dispositivo preferido no está disponible. Tenga en cuenta que la función midiOutMessage no genera esta marca: la API midiOut siempre usa solo el dispositivo preferido. La marca que genera la llamada waveInMessage o waveOutMessage se aplica al dispositivo preferido para las API waveIn y waveOut , independientemente de si la llamada se realiza a waveInMessage o waveOutMessage.

Las funciones xxxMessage aceptan este valor en lugar de un identificador de dispositivo válido para permitir que una aplicación determine el identificador de dispositivo predeterminado sin tener que abrir primero un dispositivo. Para obtener más información, consulte Acceso al identificador de dispositivo 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)