Método IMediaPosition::p ut_CurrentPosition (control.h)
[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 |
|---|---|
|
O grafo foi pausado e está em transição de volta para um estado em execução. |
|
Êxito. |
|
Argumento inválido. |
|
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 |