Compartilhar via


Função midiInGetDevCaps (mmeapi.h)

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

Sintaxe

MMRESULT midiInGetDevCaps(
  UINT         uDeviceID,
  LPMIDIINCAPS pmic,
  UINT         cbmic
);

Parâmetros

uDeviceID

Identificador do dispositivo de entrada MIDI. O identificador do dispositivo varia de zero a um menor 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 MIDIINCAPS preenchida com informações sobre os recursos do dispositivo.

cbmic

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

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.
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.

Comentários

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

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

Funções MIDI