Compartir a través de


Función waveInGetDevCaps (mmeapi.h)

La función waveInGetDevCaps recupera las funcionalidades de un dispositivo de entrada de audio de forma de onda determinado.

Syntax

MMRESULT waveInGetDevCaps(
  UINT         uDeviceID,
  LPWAVEINCAPS pwic,
  UINT         cbwic
);

Parámetros

uDeviceID

Identificador del dispositivo de entrada de audio de forma de onda. Puede ser un identificador de dispositivo o un identificador de un dispositivo abierto de entrada de audio de forma de onda.

pwic

Puntero a una estructura WAVEINCAPS que se va a rellenar con información sobre las funcionalidades del dispositivo.

cbwic

Tamaño, en bytes, de la estructura WAVEINCAPS .

Valor devuelto

Devuelve MMSYSERR_NOERROR si se ejecuta correctamente o si se produce un error. Entre los posibles valores de error se incluyen los siguientes.

Código de retorno Description
MMSYSERR_BADDEVICEID El identificador de dispositivo especificado está fuera del intervalo.
MMSYSERR_NODRIVER No hay ningún controlador de dispositivo presente.
MMSYSERR_NOMEM No se puede asignar o bloquear la memoria.

Observaciones

Use esta función para determinar el número de dispositivos de entrada de audio de forma de onda presentes en el sistema. Si el valor especificado por el parámetro uDeviceID es un identificador de dispositivo, puede variar de cero a uno menor que el número de dispositivos presentes. La constante WAVE_MAPPER también se puede usar como identificador de dispositivo. Solo los bytes cbwic (o menos) de información se copian en la ubicación a la que apunta pwic. Si cbwic es cero, no se copia nada y la función devuelve cero.

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
Header mmeapi.h (incluya Windows.h)
Library Winmm.lib
DLL de Winmm.dll

Consulte también

Funciones de forma de onda de audio