Função mixerGetDevCapsA (mmeapi.h)
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 MIXERCAPS .
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 |
|---|---|
|
O identificador de dispositivo especificado está fora do intervalo. |
|
O identificador do dispositivo do mixer é inválido. |
|
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 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 um UINT.
Observação
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 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
| 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 |