Método IAMTimelineSplittable::SplitAt

[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 SplitAt método divide o objeto no momento especificado.

Sintaxe

HRESULT SplitAt(
   REFERENCE_TIME Time
);

Parâmetros

Hora

Hora em que dividir o objeto, em relação ao início do linha do tempo, em unidades de 100 nanossegundos.

Retornar valor

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

Código de retorno Descrição
S_FALSE
Nada para dividir.
S_OK
Êxito.
E_INVALIDARG
O objeto não existe no momento.
E_OUTOFMEMORY
Memória insuficiente.

 

Comentários

Se você dividir uma origem, efeito ou transição, esse método criará um segundo objeto do mesmo tipo. O objeto original é truncado no tempo de divisão especificado e o novo objeto substitui a parte truncada. O novo objeto herda todas as mesmas propriedades. Em um objeto de origem, o método também divide todos os efeitos que se enquadram no tempo de divisão.

Chamar esse método em uma faixa divide todas as fontes, os efeitos e as transições contidos na faixa no tempo de divisão especificado. Ele não cria uma segunda faixa. (Uma faixa começa no momento zero e se estende ao infinito.)

Para uma faixa, se o tempo de divisão for posterior a tudo na faixa, o método retornará S_FALSE. Para qualquer outro objeto, se o tempo de divisão não se enquadrar em nenhum lugar dentro do objeto, o método retornará E_INVALIDARG.

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

IAMTimelineSplittable Interface

Códigos de erro e êxito