Función waveInGetDevCapsA (mmeapi.h)

La función waveInGetDevCapsA recupera las funciones de un dispositivo de entrada de forma de onda determinado. Esta es la versión ANSI de esta función.

Syntax

MMRESULT waveInGetDevCapsA(
  UINT_PTR      uDeviceID,
  LPWAVEINCAPSA 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 WAVEINCAPSA que se va a rellenar con información sobre las funcionalidades del dispositivo.

cbwic

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

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