Share via

Função auxGetDevCapsW (mmeapi.h)

  • Artigo

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

Sintaxe

MMRESULT auxGetDevCapsW(
  UINT_PTR   uDeviceID,
  LPAUXCAPSW 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 .

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.

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.

Observação

O cabeçalho mmeapi.h define auxGetDevCaps 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

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

Áudio de forma de onda

Funções waveform