Compartilhar via


Função waveOutGetDevCapsW (mmeapi.h)

A função waveOutGetDevCapsW recupera os recursos de um determinado dispositivo de saída waveform-audio. Esta é a versão Unicode da função.

Sintaxe

MMRESULT waveOutGetDevCapsW(
  UINT_PTR       uDeviceID,
  LPWAVEOUTCAPSW 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 WAVEOUTCAPSW a ser preenchida com informações sobre os recursos do dispositivo.

cbwoc

Tamanho, em bytes, da estrutura WAVEOUTCAPSW .

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
Servidor mínimo compatível Windows 2000 Server
Header mmeapi.h
Library Winmm.lib
de DLL Winmm.dll

Consulte também

Áudio de forma de onda

Funções de forma de onda