Função mixerGetDevCapsA (mmeapi.h)

Artigo
11/20/2024

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

Valor de retorno

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.

Observações

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 a menos 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 umUINT .

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	mmeapi.h (inclua Windows.h)
biblioteca	Winmm.lib
de DLL	Winmm.dll

Consulte também

Funções do Desempate de Áudio

de Audio Mixers

Compartilhar via