Share via

Função midiInGetDevCapsW (mmeapi.h)

  • Artigo

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

Sintaxe

MMRESULT midiInGetDevCapsW(
  UINT_PTR      uDeviceID,
  LPMIDIINCAPSW 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 .

Observação

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

Confira também

Funções MIDI