Compartilhar via

Função waveInGetPosition (mmeapi.h)

  • Artigo

[waveInGetPosition não tem mais suporte para uso a partir do Windows Vista. Em vez disso, use IAudioClock::GetPosition.]

A função waveInGetPosition recupera a posição de entrada atual do dispositivo de entrada waveform-audio especificado.

Sintaxe

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

Parâmetros

hwi

Manipule para o dispositivo de entrada waveform-audio.

pmmt

Ponteiro para uma estrutura MMTIME .

cbmmt

Tamanho, em bytes, da estrutura MMTIME .

Retornar valor

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 Descrição
MMSYSERR_INVALHANDLE
 O identificador de dispositivo especificado é inválido.
MMSYSERR_NODRIVER
 Nenhum driver de dispositivo está presente.
MMSYSERR_NOMEM
 Não é possível alocar ou bloquear memória.

Comentários

Antes de chamar essa função, defina o membro wType da estrutura MMTIME para indicar o formato de hora desejado. Depois de chamar essa função, marcar wType para determinar se há suporte para o formato de hora desejado. Se não houver suporte para o formato, o membro especificará um formato alternativo.

A posição é definida como zero quando o dispositivo é aberto ou redefinido.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mmeapi.h (inclua Windows.h)
Biblioteca Winmm.lib
DLL Winmm.dll

Confira também

Áudio de forma de onda

Funções de forma de onda