IDCompositionAnimation::SetAbsoluteBeginTime, méthode (dcompanimation.h)

Définit l’heure absolue à laquelle la fonction d’animation démarre.

Syntaxe

HRESULT SetAbsoluteBeginTime(
  [in] LARGE_INTEGER beginTime
);

Paramètres

[in] beginTime

Type : LARGE_INTEGER

Heure de début de cette animation.

Valeur retournée

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur DirectComposition .

Notes

Par défaut, une fonction d’animation démarre lorsque la première image de l’animation prend effet. Par exemple, si une application crée une fonction d’animation simple avec une seule primitive au décalage zéro, associe l’animation à une propriété, puis appelle la méthode IDCompositionDevice::Commit , la première image qui inclut le commit échantillonne l’animation au décalage zéro pour la première primitive.

Cela implique que l’heure de début par défaut réelle de toutes les animations varie en fonction du temps entre le moment où l’application crée l’animation et appelle Commit et le temps nécessaire au moteur de composition pour récupérer les modifications validées. L’application peut utiliser la méthode SetAbsoluteBeginTime pour exercer un contrôle plus fin sur l’heure de début d’une animation.

Cette méthode ne contrôle pas le moment où les animations prennent effet ; cela affecte uniquement la façon dont les animations sont échantillonnées après leur démarrage. Si l’application spécifie l’heure exacte de l’image suivante comme heure de début absolue, le résultat est identique à ne pas appeler cette méthode du tout. Si l’heure de début spécifiée est différente de l’heure de l’image suivante, le résultat est l’un des suivants :

• Si l’heure spécifiée est postérieure à l’heure d’exécution suivante, le début de l’animation est retardé jusqu’à l’heure de début spécifiée.
• Si l’heure spécifiée est antérieure à l’heure d’exécution suivante, le début de l’animation est supprimé et l’échantillonnage commence dans la fonction d’animation.

Spécifications

Voir aussi

IDCompositionAnimation