Share via

Función waveInGetDevCaps (mmeapi.h)

  • Artículo

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

Sintaxis

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

Parámetros

uDeviceID

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

pwic

Puntero a una estructura WAVEINCAPS que se 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 devuelto Descripción
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.

Comentarios

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 se copian bytes cbwic (o menos) de información en la ubicación a la que apunta pwic. Si cbwic es cero, no se copia nada y la función devuelve cero.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mmeapi.h (incluye Windows.h)
Library Winmm.lib
Archivo DLL Winmm.dll

Consulte también

Audio de forma de onda

Funciones de forma de onda