Compartilhar via

Mensagens do dispositivo System-Intercepted

As seguintes funções multimídia do Windows fornecem uma maneira de os chamadores passarem mensagens para dispositivos de áudio herdados:

Algumas dessas mensagens de dispositivo são tratadas diretamente pelo driver do dispositivo e algumas são tratadas pelo sistema em nome do dispositivo.

Esta seção discute apenas as mensagens interceptadas pelo sistema e manipuladas sem nunca serem passadas para o driver do dispositivo. Mensagens interceptadas pelo sistema podem obter o dispositivo preferencial para comunicações de voz ou uso geral de áudio. Além disso, as mensagens interceptadas pelo sistema podem fornecer as seguintes informações sobre um dispositivo específico:

  • O nome da interface do dispositivo

    Para obter informações sobre nomes de interface do dispositivo, consulte Introdução às Interfaces de Dispositivo.

  • O número do devnode Plug and Play do dispositivo

    For information about devnodes, see Device Tree.

  • Se o dispositivo pode ser usado por um mapeador

    Um mapeador seleciona um dispositivo apropriado mapeando os requisitos de um aplicativo para um dos dispositivos disponíveis no sistema. Para obter mais informações sobre mapeadores, consulte a documentação do SDK do Microsoft Windows.

Para obter informações sobre outros tipos de mensagens de dispositivo, consulte a documentação do SDK do Windows.

An XxxMessage function has the following syntax:

DWORD XxxMessage(
<device ID>,
    UINT  uMsg,
    DWORD_PTR  dwParam1,
    DWORD_PTR  dwParam2
    );

O primeiro parâmetro é uma ID do dispositivo. The auxOutMessage function definition specifies this parameter to be of type UINT, as expected. However, in the case of waveInMessage, waveOutMessage, midiInMessage, midiOutMessage, or mixerMessage, the caller must cast the device ID to handle type HWAVEIN, HWAVEOUT, HMIDIIN, HMIDIOUT, or HMIXER, respectively. Observe que, se o chamador fornecer um identificador válido em vez de uma ID do dispositivo para esse parâmetro, a função falhará e retornará o código de erro MMSYSERR_NOSUPPORT.

The uMsg parameter specifies a message value (for example, DRV_QUERYDEVICEINTERFACE). Para obter uma lista de mensagens específicas do driver, consulte o arquivo de cabeçalho Mmddk.h.

The meaning of parameters dwParam1 and dwParam2 depends on the message. For example, a particular message might require that dwParam1 be a ULONG value; the caller must cast this value to type DWORD_PTR to satisfy the function definition.

A função retornará MMERR_NOERROR se a chamada for bem-sucedida ou um código de status de erro se não o fizer.

For more information about the XxxMessage functions, see the Windows SDK documentation.

O arquivo de cabeçalho Mmddk.h define as seguintes mensagens de dispositivo interceptadas pelo sistema:

DRV_QUERYDEVICEINTERFACE

Para obter mais informações, consulte Como obter um nome de interface do dispositivo.

DRV_QUERYDEVICEINTERFACESIZE

Para obter mais informações, consulte Como obter um nome de interface do dispositivo.

DRV_QUERYDEVNODE

Consultas para o número de devnode de um dispositivo.

DRV_QUERYMAPPABLE

Consulta se um dispositivo pode ser usado por um mapeador.

DRVM_MAPPER_CONSOLEVOICECOM_GET

Para obter mais informações, consulte Preferred Voice-Communications Device ID.

DRVM_MAPPER_PREFERRED_GET

Para obter mais informações, consulte Acessar a ID do dispositivo preferencial.

  • Last updated on