Acceso al identificador de dispositivo preferido

Las funciones multimedia de Windows waveInMessage, waveOutMessage y midiOutMessage pueden recuperar el identificador de dispositivo del dispositivo preferido. Estas tres funciones obtienen los identificadores de dispositivo preferidos para la entrada de onda, la salida de onda y la salida MIDI, respectivamente. Esta información es útil para los programas de aplicación que, por ejemplo, permiten a los usuarios seleccionar un dispositivo para abrirlo desde una lista de dos o más dispositivos. Normalmente, una aplicación de este tipo debe indicar cuál de los dispositivos de la lista es el dispositivo preferido.

El dispositivo preferido es el dispositivo que el usuario selecciona a través del panel de control multimedia, mmsys.cpl. Si una aplicación multimedia de Windows o DirectSound no especifica explícitamente un dispositivo, el dispositivo preferido se selecciona de forma predeterminada.

Para recuperar el identificador de dispositivo del dispositivo de audio preferido actual, una aplicación llama a la función xxxMessage con el parámetro message establecido en la constante DRVM_MAPPER_PREFERRED_GET.

Al llamar a la función waveInMessage, waveOutMessage o midiOutMessage con el mensaje de DRVM_MAPPER_PREFERRED_GET, especifique el valor del identificador del dispositivo como WAVE_MAPPER (para waveInMessage o waveOutMessage) o MIDI_MAPPER (para midiOutMessage) y convierta este valor en el tipo de identificador adecuado: HWAVEIN, HWAVEOUT o HMIDIOUT. Las funciones xxxMessage aceptan este valor en lugar de un identificador de dispositivo válido para que una aplicación pueda consultar el identificador de dispositivo predeterminado sin tener que abrir primero un dispositivo. Para obtener más información sobre las funciones xxxMessage , consulte Mensajes de dispositivo interceptados por el sistema.

El asignador intercepta el mensaje DRVM_MAPPER_PREFERRED_GET para el dispositivo de destino (waveIn, waveOut o midiOut). Para obtener información sobre los asignadores para dispositivos wave y MIDI, consulte la documentación de Microsoft Windows SDK.