Compartir a través de

Función waveInGetPosition (mmeapi.h)

  • Artículo

[waveInGetPosition ya no se admite para su uso en Windows Vista. En su lugar, use IAudioClock::GetPosition.]

La función waveInGetPosition recupera la posición de entrada actual del dispositivo de entrada de forma de onda dado.

Sintaxis

MMRESULT waveInGetPosition(
  HWAVEIN  hwi,
  LPMMTIME pmmt,
  UINT     cbmmt
);

Parámetros

hwi

Controle el dispositivo de entrada de audio con forma de onda.

pmmt

Puntero a una estructura MMTIME .

cbmmt

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

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_INVALHANDLE
 El identificador de dispositivo especificado no es válido.
MMSYSERR_NODRIVER
 No hay ningún controlador de dispositivo presente.
MMSYSERR_NOMEM
 No se puede asignar o bloquear la memoria.

Comentarios

Antes de llamar a esta función, establezca el miembro wType de la estructura MMTIME para indicar el formato de hora que desee. Después de llamar a esta función, compruebe wType para determinar si se admite el formato de hora deseado. Si no se admite el formato, el miembro especificará un formato alternativo.

La posición se establece en cero cuando se abre o restablece el dispositivo.

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