Função auxGetDevCaps (mmeapi.h)

  • Artigo

A função auxGetDevCaps recupera os recursos de um determinado dispositivo de saída auxiliar.

Sintaxe

MMRESULT auxGetDevCaps(
  UINT      uDeviceID,
  LPAUXCAPS pac,
  UINT      cbac
);

Parâmetros

uDeviceID

Identificador do dispositivo de saída auxiliar a ser consultado. Especifique um identificador de dispositivo válido (consulte a seção de comentários a seguir) ou use a seguinte constante:

Valor Significado
AUX_MAPPER Mapeador de áudio auxiliar. A função retornará um erro se nenhum mapeador de áudio auxiliar estiver instalado.

pac

Ponteiro para uma estrutura AUXCAPS a ser preenchida com informações sobre os recursos do dispositivo.

cbac

Tamanho, em bytes, da estrutura AUXCAPS .

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.

Comentários

O identificador de dispositivo em uDeviceID varia de zero a um menor que o número de dispositivos presentes. AUX_MAPPER também podem ser usados. Use a função auxGetNumDevs para determinar o número de dispositivos auxiliares de saída presentes no sistema.

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

Áudio de forma de onda

Funções waveform