Compartilhar via


Método IAMTimelineTransable::GetTransAtTime

[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.]

Observação

[Preterido. Essa API pode ser removida de versões futuras do Windows.]

 

O GetTransAtTime método recupera a transição mais próxima da hora especificada, de acordo com as condições de limite especificadas.

Sintaxe

HRESULT GetTransAtTime(
  [out] IAMTimelineObj **ppObj,
        REFERENCE_TIME Time,
        long           SearchDirection
);

Parâmetros

ppObj [out]

Recebe um ponteiro para a interface IAMTimelineObj da transição.

Hora

Hora de iniciar a pesquisa, em unidades de 100 nanossegundos.

SearchDirection

Membro do DEXTERF_TRACK_SEARCH_FLAGS tipo enumerado que especifica as condições de limite para a pesquisa.

Retornar valor

Retorna um dos seguintes valores HRESULT :

Código de retorno Descrição
S_FALSE
Nenhuma transição foi encontrada.
S_OK
A transição foi encontrada.
E_INVALIDARG
Argumento inválido.
E_POINTER
Argumento de ponteiro NULL.

 

Comentários

Se o método retornar S_OK, a interface IAMTimelineObj retornada terá uma contagem de referência pendente. Certifique-se de liberar a interface quando terminar de usá-la.

Observação

O arquivo de cabeçalho Qedit.h não é compatível com cabeçalhos Direct3D posteriores à versão 7.

 

Observação

Para obter qedit.h, baixe o SDK do Microsoft Windows Update para Windows Vista e .NET Framework 3.0. O Qedit.h não está disponível no SDK do Microsoft Windows para Windows 7 e .NET Framework 3.5 Service Pack 1.

 

Requisitos

Requisito Valor
parâmetro
Qedit.h
Biblioteca
Strmiids.lib

Confira também

IAMTimelineTransable Interface

Códigos de erro e êxito