Método IMediaPosition::p ut_CurrentPosition (control.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O put_CurrentPosition método define a posição atual, em relação à duração total do fluxo.

Sintaxe

HRESULT put_CurrentPosition(
  [in] REFTIME llTime
);

Parâmetros

[in] llTime

Nova posição, em segundos.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes:

Código de retorno Descrição
S_FALSE
 O grafo foi pausado e está em transição de volta para um estado em execução.
S_OK
 Êxito.
E_INVALIDARG
 Argumento inválido.
E_NOTIMPL
 Não implementado.

Comentários

A posição especificada pelo parâmetro llTime é relativa à duração total, ignorando a taxa de reprodução. Por exemplo, se um arquivo de origem tiver 10 segundos de duração, definir a posição como 5,0 fará com que o grafo busque o meio do arquivo, independentemente da taxa de reprodução.

Se o grafo de filtro estiver em execução, o Gerenciador de Grafo de Filtro pausará o grafo, emitirá o comando seek e executará o grafo novamente. Se o método retornar enquanto o grafo ainda estiver fazendo a transição para um estado em execução, o valor retornado será S_FALSE.

Se um filtro for pausado quando receber um comando seek, ele deverá liberar os dados existentes antes de introduzir os dados da nova posição. Consulte IPin::BeginFlush e IPin::EndFlush.

Requisitos

   
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 control.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Códigos de erro e êxito

IMediaPosition Interface