Método IAMTimelineComp::VTrackInsBefore

[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 VTrackInsBefore método insere uma faixa virtual na composição na prioridade especificada.

Sintaxe

HRESULT VTrackInsBefore(
   IAMTimelineObj *pVirtualTrack,
   long           Priority
);

Parâmetros

pVirtualTrack

Ponteiro para a interface IAMTimelineObj da faixa virtual.

Prioridade

Prioridade na qual inserir a faixa virtual ou –1 para inserir a faixa virtual no final da lista de prioridades. A lista de prioridades determina quais clipes estão visíveis. Confira Comentários para obter mais informações.

Retornar valor

Retorna um dos seguintes valores HRESULT :

Código de retorno	Descrição
S_OK	Êxito.
E_INVALIDARG	Argumento inválido.
E_NOINTERFACE	O objeto não é uma faixa virtual.

 

Comentários

Cada faixa virtual na composição tem um nível de prioridade exclusivo. Os níveis de prioridade variam de 0 a n a 1, em que n é o número de faixas virtuais na composição. Para grupos de vídeo, uma faixa virtual oculta todas as faixas virtuais com um nível de prioridade mais baixo, exceto em locais onde a faixa está vazia ou contém uma transição. Você pode pensar em faixas virtuais como sendo camadas na composição final. A Faixa 1 está em camadas sobre a faixa 0, a faixa 2 está em camadas na parte superior da faixa 1 e assim por diante.

Se você especificar -1 para o parâmetro Priority , a faixa virtual será inserida no final da lista, com um valor de prioridade mais alto do que as faixas existentes. Se você especificar um valor de prioridade que já existe na composição, cada faixa com uma prioridade igual ou maior aumentará um nível de prioridade.

Exemplo: a faixa A tem prioridade 0 e a faixa B tem prioridade 1. Se a faixa C for inserida na prioridade 0, a faixa A passará para a prioridade 1 e a faixa B passará para a prioridade 2.

Se a prioridade especificada for maior que o número atual de faixas na composição, o método falhará.

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

IAMTimelineComp Interface

Códigos de erro e êxito