Compartilhar via

Função midiOutGetDevCapsW (mmeapi.h)

  • Artigo

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

Sintaxe

MMRESULT midiOutGetDevCapsW(
  UINT_PTR       uDeviceID,
  LPMIDIOUTCAPSW 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 pode carregar a descrição da cadeia de caracteres mapeador.

Comentários

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

Observação

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