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 |
|---|---|
|
Êxito. |
|
Nenhum objeto do tipo especificado. |
|
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 |
|
| Biblioteca |
|
Confira também