Método IAMTimelineComp::GetRecursiveLayerOfType

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

Observação

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

 

O GetRecursiveLayerOfType método executa uma ordenação de profundidade das faixas virtuais contidas nessa composição e recupera a nª faixa virtual dessa ordenação.

Sintaxe

HRESULT GetRecursiveLayerOfType(
  [out] IAMTimelineObj      **ppVirtualTrack,
        long                WhichLayer,
        TIMELINE_MAJOR_TYPE Type
);

Parâmetros

ppVirtualTrack [out]

Recebe um ponteiro para a interface IAMTimelineObj da faixa virtual.

WhichLayer

Especifica qual faixa virtual recuperar, indexada de zero.

Tipo

Membro do TIMELINE_MAJOR_TYPE tipo enumerado que especifica se as faixas devem ser incluídas na pesquisa.

Retornar valor

Retorna um dos seguintes valores HRESULT :

Código de retorno	Descrição
S_OK	Êxito.
E_INVALIDARG	Nenhum objeto do tipo especificado.
E_POINTER	Argumento de ponteiro NULL.

 

Comentários

Normalmente, um aplicativo não precisará chamar esse método.

Se o parâmetro Type for TIMELINE_MAJOR_TYPE_TRACK, a ordenação de profundidade incluirá faixas. Caso contrário, ele inclui apenas composições e grupos. O objeto em si está incluído na ordenação.

Por exemplo, na disposição a seguir, a partir da Composição A, a ordenação seria B, C, F, D, E, A.

Se o método for bem-sucedido, 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

IAMTimelineComp Interface

Códigos de erro e êxito