IMFTimer::SetTimer-Methode (mfidl.h)

  • Artikel

Legt einen Timer fest, der einen Rückruf zum angegebenen Zeitpunkt aufruft.

Syntax

HRESULT SetTimer(
  [in]  DWORD            dwFlags,
  [in]  LONGLONG         llClockTime,
  [in]  IMFAsyncCallback *pCallback,
  [in]  IUnknown         *punkState,
  [out] IUnknown         **ppunkKey
);

Parameter

[in] dwFlags

Bitweise OR mit 0 oder mehr Flags aus der MFTIMER_FLAGS-Enumeration .

[in] llClockTime

Die Zeit, zu der der Timer in Einheiten der Frequenz der Uhr ausgelöst werden soll. Die Zeit ist entweder absolut oder relativ zur aktuellen Zeit, abhängig vom Wert von dwFlags.

[in] pCallback

Zeiger auf die IMFAsyncCallback-Schnittstelle eines Rückrufobjekts. Der Aufrufer muss diese Schnittstelle implementieren. Die Invoke-Methode des Rückrufs wird zu dem im llClockTime-Parameter angegebenen Zeitpunkt aufgerufen.

[in] punkState

Zeiger auf die IUnknown-Schnittstelle eines Zustandsobjekts, das vom Aufrufer definiert wird. Dieser Parameter kann NULL sein. Sie können dieses Objekt verwenden, um Zustandsinformationen zu enthalten. Das -Objekt wird an den Aufrufer zurückgegeben, wenn der Rückruf aufgerufen wird.

[out] ppunkKey

Empfängt einen Zeiger auf die IUnknown-Schnittstelle eines Abbruchobjekts. Der Aufrufer muss die Schnittstelle freigeben. Um den Timer abzubrechen, übergeben Sie diesen Zeiger an die IMFTimer::CancelTimer-Methode . Dieser Parameter kann NULL sein.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
MF_E_SHUTDOWN
 Die Uhr wurde heruntergefahren.
MF_S_CLOCK_STOPPED
 Die Methode war erfolgreich, aber die Uhr wird angehalten.

Hinweise

Wenn die Uhr beendet wird, gibt die Methode MF_S_CLOCK_STOPPED zurück. Der Rückruf wird erst aufgerufen, wenn die Uhr gestartet wird.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfuuid.lib

Weitere Informationen

IMFTimer