Método IAMTimeline::CreateEmptyNode

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

O CreateEmptyNode método cria um novo objeto linha do tempo.

Use esse método para criar objetos linha do tempo, em vez da função CoCreateInstance, porque esse método executa rotinas de inicialização importantes. Cada objeto criado por esse método dá suporte a pelo menos a interface IAMTimelineObj , juntamente com outras interfaces específicas para esse tipo de objeto.

Sintaxe

HRESULT CreateEmptyNode(
  [out] IAMTimelineObj      **ppObj,
        TIMELINE_MAJOR_TYPE Type
);

Parâmetros

ppObj [out]

Recebe um ponteiro para a interface IAMTimelineObj do novo objeto.

Tipo

Membro do TIMELINE_MAJOR_TYPE tipo enumerado, especificando o tipo de objeto a ser criado.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Não adicione o novo objeto a outra instância linha do tempo. Cada objeto em um linha do tempo deve ser criado por esse linha do tempo.

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.

Requisitos

Confira também

IAMTimeline Interface

Códigos de erro e êxito