Método IAMTimeline::CreateEmptyNode

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El CreateEmptyNode método crea un nuevo objeto timeline.

Use este método para crear objetos de escala de tiempo, en lugar de la función CoCreateInstance , ya que este método realiza rutinas de inicialización importantes. Cada objeto creado por este método admite al menos la interfaz IAMTimelineObj , junto con otras interfaces específicas de ese tipo de objeto.

Sintaxis

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

Parámetros

ppObj [out]

Recibe un puntero a la interfaz IAMTimelineObj del nuevo objeto.

Tipo

Miembro del TIMELINE_MAJOR_TYPE tipo enumerado, especificando el tipo de objeto que se va a crear.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Observaciones

No agregue el nuevo objeto a otra instancia de escala de tiempo. Cada objeto de una escala de tiempo debe crearse con esa escala de tiempo.

Si el método se ejecuta correctamente, la interfaz IAMTimelineObj que devuelve tiene un recuento de referencias pendiente. Asegúrese de liberar la interfaz cuando haya terminado de usarla.

Requisitos

Consulte también

IAMTimeline (interfaz)

Códigos de error y éxito