Compartilhar via


Função waveOutGetDevCaps (mmeapi.h)

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 .

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

Observações

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 a menos do que o número de dispositivos presentes. A constante WAVE_MAPPER também pode ser usada como um identificador de dispositivo. Somente os bytes cbwoc (ou menos) de informações são copiados para o local apontado pela pwoc. Se cbwoc for zero, nada será copiado e a função retornará zero.

Requirements

Requirement Value
Cliente mínimo suportado Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header mmeapi.h (inclua Windows.h)
Library Winmm.lib
de DLL Winmm.dll

Consulte também

Áudio de forma de onda

Funções de forma de onda