Share via

Método IDCompositionAnimation::SetAbsoluteBeginTime (dcompanimation.h)

  • Artículo

Establece la hora absoluta en la que se inicia la función de animación.

Sintaxis

HRESULT SetAbsoluteBeginTime(
  [in] LARGE_INTEGER beginTime
);

Parámetros

[in] beginTime

Tipo: LARGE_INTEGER

Hora de inicio de esta animación.

Valor devuelto

Tipo: HRESULT

Si la función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT. Consulte Códigos de error de DirectComposition para obtener una lista de códigos de error.

Comentarios

De forma predeterminada, una función de animación se inicia cuando el primer fotograma de la animación surte efecto. Por ejemplo, si una aplicación crea una función de animación simple con un único primitivo en el desplazamiento cero, asocia la animación con alguna propiedad y, a continuación, llama al método IDCompositionDevice::Commit , el primer fotograma que incluye la confirmación muestra la animación en el desplazamiento cero para la primera primitiva.

Esto implica que la hora de inicio predeterminada real de todas las animaciones varía en función del tiempo entre el momento en que la aplicación crea la animación y llama a Commit, hasta el momento en que el motor de composición tarda en recoger los cambios confirmados. La aplicación puede usar el método SetAbsoluteBeginTime para ejercer un control más preciso sobre la hora de inicio de una animación.

Este método no controla cuándo surten efecto las animaciones; solo afecta a cómo se muestrean las animaciones después de que se inicien. Si la aplicación especifica la hora exacta del siguiente fotograma como hora de inicio absoluta, el resultado es el mismo que no llamar a este método en absoluto. Si la hora de inicio especificada es diferente de la hora del siguiente fotograma, el resultado es uno de los siguientes:

  • Si la hora especificada es posterior a la siguiente hora del fotograma, el inicio de la animación se retrasa hasta la hora de inicio especificada.
  • Si la hora especificada es anterior a la siguiente hora del fotograma, se quita el principio de la animación y el muestreo comienza en la función de animación.

Requisitos

   
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado dcompanimation.h
Library Dcomp.lib
Archivo DLL Dcomp.dll

Consulte también

IDCompositionAnimation