Compartilhar via


Função mixerGetDevCaps (mmeapi.h)

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

Sintaxe

MMRESULT mixerGetDevCaps(
  UINT        uMxId,
  LPMIXERCAPS 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 .

Retornar valor

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 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.

Requisitos

Requisito Valor
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 do Mixer de Áudio

Misturadores de áudio