IMFAsyncResult::GetState-Methode (mfobjects.h)

  • Artikel

Gibt das vom Aufrufer in der asynchronen Begin-Methode angegebene Zustandsobjekt zurück.

Syntax

HRESULT GetState(
  [out] IUnknown **ppunkState
);

Parameter

[out] ppunkState

Empfängt einen Zeiger auf die IUnknown-Schnittstelle des Zustandsobjekts. Wenn der Wert nicht NULL ist, muss der Aufrufer die Schnittstelle freigeben.

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.
E_POINTER
 Diesem asynchronen Ergebnis ist kein Zustandsobjekt zugeordnet.

Hinweise

Der Aufrufer der asynchronen Methode gibt das Zustandsobjekt an und kann es für jeden vom Aufrufer definierten Zweck verwenden. Das Zustandsobjekt kann NULL sein. Wenn das Zustandsobjekt NULL ist, gibt GetStateE_POINTER zurück.

Wenn Sie eine asynchrone Methode implementieren, legen Sie das Zustandsobjekt für den über den punkState-Parameter der MFCreateAsyncResult-Funktion fest.

Diese Schnittstelle ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:

  • Windows XP mit Service Pack 2 (SP2) und höher.
  • Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition vom Oktober 2006) installiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfobjects.h (include Mfidl.h)
Bibliothek Mfuuid.lib

Weitere Informationen

Asynchrone Rückrufmethoden

IMFAsyncResult