Metodo IDCompositionAnimation::SetAbsoluteBeginTime (dcompanimation.h)

  • Articolo

Imposta l'ora assoluta in cui viene avviata la funzione di animazione.

Sintassi

HRESULT SetAbsoluteBeginTime(
  [in] LARGE_INTEGER beginTime
);

Parametri

[in] beginTime

Tipo: LARGE_INTEGER

Ora di inizio per questa animazione.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore directComposition .

Commenti

Per impostazione predefinita, una funzione di animazione viene avviata quando diventa effettivo il primo fotogramma dell'animazione. Ad esempio, se un'applicazione crea una funzione di animazione semplice con una singola primitiva con offset zero, associa l'animazione ad alcune proprietà e quindi chiama il metodo IDCompositionDevice::Commit , il primo fotogramma che include il commit campiona l'animazione in corrispondenza dello zero dell'offset per la prima primitiva.

Ciò implica che l'ora di inizio predefinita effettiva di tutte le animazioni varia a seconda del tempo tra il momento in cui l'applicazione crea l'animazione e chiama Commit, al tempo necessario al motore di composizione per raccogliere le modifiche di cui è stato eseguito il commit. L'applicazione può usare il metodo SetAbsoluteBeginTime per esercitare un controllo più corretto sull'ora di inizio di un'animazione.

Questo metodo non controlla quando le animazioni diventano effettive; influisce solo sulla modalità di campionamento delle animazioni dopo l'avvio. Se l'applicazione specifica l'ora esatta del fotogramma successivo come ora di inizio assoluta, il risultato corrisponde a quello di non chiamare affatto questo metodo. Se l'ora di inizio specificata è diversa dall'ora del frame successivo, il risultato è uno dei seguenti:

  • Se l'ora specificata è successiva all'intervallo successivo, l'avvio dell'animazione viene ritardato fino all'ora di inizio specificata.
  • Se l'ora specificata è precedente all'intervallo successivo, l'inizio dell'animazione viene eliminato e il campionamento inizia nella funzione di animazione.

Requisiti

   
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione dcompanimation.h
Libreria Dcomp.lib
DLL Dcomp.dll

Vedi anche

IDCompositionAnimation