função auxGetDevCapsW (mmeapi.h)
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 seguinte seção de comentários) 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 de do AUXCAPS
cbac
Tamanho, em bytes, da estrutura de do AUXCAPS
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 |
|---|---|
|
O identificador de dispositivo especificado está fora do intervalo. |
Observações
O identificador de dispositivo no uDeviceID varia de zero a um a menos do que o número de dispositivos presentes. AUX_MAPPER também pode ser usado. Use a função auxGetNumDevs para determinar o número de dispositivos de saída auxiliares presentes no sistema.
Nota
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 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 |