Share via

Função midiOutGetDevCaps (mmeapi.h)

  • Artigo

A função midiOutGetDevCaps consulta um dispositivo de saída MIDI especificado para determinar seus recursos.

Sintaxe

MMRESULT midiOutGetDevCaps(
  UINT          uDeviceID,
  LPMIDIOUTCAPS pmoc,
  UINT          cbmoc
);

Parâmetros

uDeviceID

Identificador do dispositivo de saída MIDI. O identificador de dispositivo especificado por esse parâmetro varia de zero a um menor que o número de dispositivos presentes. A constante MIDI_MAPPER também é um identificador de dispositivo válido.

Esse parâmetro também pode ser um identificador de dispositivo convertido corretamente.

pmoc

Ponteiro para uma estrutura MIDIOUTCAPS . Essa estrutura é preenchida com informações sobre os recursos do dispositivo.

cbmoc

Tamanho, em bytes, da estrutura MIDIOUTCAPS . Somente bytes cbMidiOutCaps (ou menos) de informações são copiados para o local apontado por lpMidiOutCaps. Se cbMidiOutCaps 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 consegue carregar a descrição da cadeia de caracteres do mapeador.

Comentários

Para determinar o número de dispositivos de saída MIDI presentes no sistema, use a função midiOutGetNumDevs .

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