Função midiOutGetDevCapsA (mmeapi.h)

Artigo
11/20/2024

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

Sintaxe

MMRESULT midiOutGetDevCapsA(
  UINT_PTR       uDeviceID,
  LPMIDIOUTCAPSA 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 a menos do 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 de MIDIOUTCAPS . Essa estrutura é preenchida com informações sobre os recursos do dispositivo.

cbmoc

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

Observações

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

Nota

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