Interface IMediaSeeking (strmif.h)
[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na 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 Captura de Áudio/Vídeo no 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.]
A IMediaSeeking interface contém métodos para buscar uma posição dentro de um fluxo e para definir a taxa de reprodução. O Gerenciador de Grafo de Filtro expõe essa interface, assim como filtros ou pinos individuais. Os aplicativos devem consultar o Gerenciador de Grafo de Filtro para a interface.
O Gerenciador de Grafo de Filtro distribui qualquer IMediaSeeking chamada para cada um dos filtros do renderizador no grafo. Os filtros do renderizador enviam a chamada upstream para os filtros de origem. Essa sequência de eventos garante que todos os fluxos permaneçam sincronizados. Se qualquer uma das chamadas distribuídas retornar um erro, o Gerenciador de Grafo de Filtro retornará o primeiro valor de erro recebido, mesmo que algumas das chamadas distribuídas tenham êxito. Uma exceção é E_NOTIMPL: o Gerenciador de Grafo de Filtro não retorna E_NOTIMPL a menos que tenha sido retornado por todas as chamadas distribuídas.
Um aplicativo pode buscar o grafo enquanto o grafo estiver em qualquer estado (em execução, pausado ou interrompido). Se o grafo estiver em execução, o Gerenciador do Grafo de Filtro pausará o grafo antes de emitir o comando seek. Em seguida, ele executa o grafo novamente. Todas as operações de busca são independentes da taxa de reprodução atual. A busca de operações faz com que todos os dados de mídia pendentes sejam liberados do grafo.
Para todos os IMediaSeeking parâmetros que especificam tempo, a unidade de tempo depende do formato de hora atual. Para definir o formato de hora, chame o método IMediaSeeking::SetTimeFormat . Os formatos de tempo são GUIDs (identificadores globalmente exclusivos) definidos em uuids.h. Para obter mais informações, consulte GUIDs de formato de tempo.
Herança
A interface IMediaSeeking herda da interface IUnknown . IMediaSeeking também tem esses tipos de membros:
Métodos
A interface IMediaSeeking tem esses métodos.
| IMediaSeeking::CheckCapabilities O método CheckCapabilities consulta se um fluxo especificou a busca de recursos. |
| IMediaSeeking::ConvertTimeFormat O método ConvertTimeFormat converte de um formato de vez em outro. |
| IMediaSeeking::GetAvailable O método GetAvailable recupera o intervalo de vezes em que a busca é eficiente. |
| IMediaSeeking::GetCapabilities O método GetCapabilities recupera todos os recursos de busca do fluxo. |
| IMediaSeeking::GetCurrentPosition O método GetCurrentPosition recupera a posição atual em relação à duração total do fluxo. |
| IMediaSeeking::GetDuration O método GetDuration obtém a duração do fluxo. |
| IMediaSeeking::GetPositions O método GetPositions recupera a posição atual e a posição de parada, em relação à duração total do fluxo. |
| IMediaSeeking::GetPreroll O método GetPreroll recupera a quantidade de dados que serão enfileirados antes da posição inicial. |
| IMediaSeeking::GetRate O método GetRate recupera a taxa de reprodução. |
| IMediaSeeking::GetStopPosition O método GetStopPosition recupera a hora em que a reprodução será interrompida, em relação à duração do fluxo. |
| IMediaSeeking::GetTimeFormat O método GetTimeFormat recupera o formato de tempo que está sendo usado atualmente para operações de busca. |
| IMediaSeeking::IsFormatSupported O método IsFormatSupported determina se há suporte para um formato de tempo especificado para operações de busca. |
| IMediaSeeking::IsUsingTimeFormat O método IsUsingTimeFormat determina se as operações de busca estão atualmente usando um formato de tempo especificado. |
| IMediaSeeking::QueryPreferredFormat O método QueryPreferredFormat recupera o formato de tempo preferencial para busca. |
| IMediaSeeking::SetPositions O método SetPositions define a posição atual e a posição de parada. |
| IMediaSeeking::SetRate O método SetRate define a taxa de reprodução. |
| IMediaSeeking::SetTimeFormat O método SetTimeFormat define o formato de tempo para operações de busca subsequentes. |
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 | strmif.h (inclua Dshow.h) |