Share via

Função waveOutGetDevCaps (mmeapi.h)

  • Artigo

A função waveOutGetDevCaps recupera os recursos de um determinado dispositivo de saída waveform-audio.

Sintaxe

MMRESULT waveOutGetDevCaps(
  UINT          uDeviceID,
  LPWAVEOUTCAPS pwoc,
  UINT          cbwoc
);

Parâmetros

uDeviceID

Identificador do dispositivo de saída waveform-audio. Ele pode ser um identificador de dispositivo ou um identificador de um dispositivo de saída de áudio de forma de onda aberta.

pwoc

Ponteiro para uma estrutura WAVEOUTCAPS a ser preenchida com informações sobre os recursos do dispositivo.

cbwoc

Tamanho, em bytes, da estrutura WAVEOUTCAPS .

Retornar valor

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_NODRIVER
 Nenhum driver de dispositivo está presente.
MMSYSERR_NOMEM
 Não é possível alocar ou bloquear memória.

Comentários

Use a função waveOutGetNumDevs para determinar o número de dispositivos de saída waveform-audio presentes no sistema. Se o valor especificado pelo parâmetro uDeviceID for um identificador de dispositivo, ele poderá variar de zero a um menor que o número de dispositivos presentes. A constante WAVE_MAPPER também pode ser usada como um identificador de dispositivo. Somente bytes cbwoc (ou menos) de informações são copiados para o local apontado por pwoc. Se cbwoc for zero, nada será copiado e a função retornará zero.

Requisitos

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

Áudio de forma de onda

Funções de forma de onda