IMFAsyncResult::GetObject-Methode (mfobjects.h)
Gibt ein Objekt zurück, das dem asynchronen Vorgang zugeordnet ist. Falls vorhanden, hängt der Typ des Objekts von der aufgerufenen asynchronen Methode ab.
Syntax
HRESULT GetObject(
[out] IUnknown **ppObject
);
Parameter
[out] ppObject
Empfängt einen Zeiger auf die IUnknown-Schnittstelle des Objekts. Wenn dem Vorgang kein Objekt zugeordnet ist, empfängt dieser Parameter den Wert NULL. 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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Diesem asynchronen Ergebnis ist kein Objekt zugeordnet. |
Hinweise
In der Regel wird dieses Objekt von der Komponente verwendet, die die asynchrone Methode implementiert. Es bietet eine Möglichkeit für die Funktion, die den Rückruf aufruft, Informationen an die asynchrone End...- Methode zu übergeben, die den Vorgang abschließt.
Wenn Sie eine asynchrone Methode implementieren, können Sie das Objekt über den punkObject-Parameter der MFCreateAsyncResult-Funktion festlegen.
Wenn der interne IUnknown-Zeiger des asynchronen Ergebnisobjekts NULL ist, gibt die Methode E_POINTER zurück.
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 |