Share via

Função mixerGetDevCapsA (mmeapi.h)

  • Artigo

A função mixerGetDevCaps consulta um dispositivo de mixer especificado para determinar seus recursos.

Sintaxe

MMRESULT mixerGetDevCapsA(
  UINT_PTR     uMxId,
  LPMIXERCAPSA pmxcaps,
  UINT         cbmxcaps
);

Parâmetros

uMxId

Identificador ou identificador de um dispositivo de mixer aberto.

pmxcaps

Ponteiro para uma estrutura MIXERCAPS que recebe informações sobre os recursos do dispositivo.

cbmxcaps

Tamanho, em bytes, da estrutura MIXERCAPS .

Valor retornado

Retorna MMSYSERR_NOERROR se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte.

Código de retorno Descrição
MMSYSERR_BADDEVICEID
 O identificador de dispositivo especificado está fora do intervalo.
MMSYSERR_INVALHANDLE
 O identificador do dispositivo do mixer é inválido.
MMSYSERR_INVALPARAM
 Um ou mais parâmetros são inválidos.

Comentários

Use a função mixerGetNumDevs para determinar o número de dispositivos de mixer presentes no sistema. O identificador de dispositivo especificado por uMxId varia de zero a um menor do que o número de dispositivos de mixer presentes.

Somente o número de bytes (ou menos) de informações especificadas em cbmxcaps é copiado para o local apontado por pmxcaps. Se cbmxcaps for zero, nada será copiado e a função retornará com êxito.

Essa função também aceita um identificador de dispositivo de mixer retornado pela função mixerOpen como o parâmetro uMxId . O aplicativo deve converter o identificador HMIXER em um UINT.

Observação

O cabeçalho mmeapi.h define mixerGetDevCaps como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mmeapi.h (inclua Windows.h)
Biblioteca Winmm.lib
DLL Winmm.dll

Confira também

Funções de mixer de áudio

Combinadores de áudio