Função midiInGetDevCapsA (mmeapi.h)

Artigo
11/20/2024

A função midiInGetDevCaps determina os recursos de um dispositivo de entrada MIDI especificado.

Sintaxe

MMRESULT midiInGetDevCapsA(
  UINT_PTR      uDeviceID,
  LPMIDIINCAPSA pmic,
  UINT          cbmic
);

Parâmetros

uDeviceID

Identificador do dispositivo de entrada MIDI. O identificador do dispositivo varia de zero a um a menos do que o número de dispositivos presentes. Esse parâmetro também pode ser um identificador de dispositivo convertido corretamente.

pmic

Ponteiro para uma estrutura de midiincaps que é preenchida com informações sobre os recursos do dispositivo.

cbmic

Tamanho, em bytes, da estrutura de MIDIINCAPS. Somente cbMidiInCaps bytes (ou menos) de informações é copiado para o local apontado por lpMidiInCaps. Se cbMidiInCaps for zero, nada será copiado e a função retornará MMSYSERR_NOERROR.

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_INVALPARAM	O ponteiro ou estrutura especificado é inválido.
MMSYSERR_NODRIVER	O driver não está instalado.
MMSYSERR_NOMEM	O sistema não pode alocar ou bloquear memória.

Observações

Para determinar o número de dispositivos de entrada MIDI presentes no sistema, use a função midiInGetNumDevs.

Nota

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

Compartilhar via