MÉTHODE IMFAsyncResult ::GetObject (mfobjects.h)

Retourne un objet associé à l’opération asynchrone. Le type d’objet, le cas échéant, dépend de la méthode asynchrone qui a été appelée.

Syntaxe

HRESULT GetObject(
  [out] IUnknown **ppObject
);

Paramètres

[out] ppObject

Reçoit un pointeur vers l’interface IUnknown de l’objet. Si aucun objet n’est associé à l’opération, ce paramètre reçoit la valeur NULL. Si la valeur n’est pas NULL, l’appelant doit libérer l’interface.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
E_POINTER	Aucun objet n’est associé à ce résultat asynchrone.

Remarques

En règle générale, cet objet est utilisé par le composant qui implémente la méthode asynchrone. Elle permet à la fonction qui appelle le rappel de transmettre des informations à la méthode End... asynchrone qui termine l’opération.

Si vous implémentez une méthode asynchrone, vous pouvez définir l’objet via le paramètre punkObject de la fonction MFCreateAsyncResult .

Si le pointeur IUnknown interne de l’objet de résultat asynchrone est NULL, la méthode retourne E_POINTER.

Cette interface est disponible sur les plateformes suivantes si les composants redistribuables du SDK Windows Media Format 11 sont installés :

• Windows XP avec Service Pack 2 (SP2) et versions ultérieures.
• Windows XP Media Center Edition 2005 avec KB900325 (Windows XP Media Center Edition 2005) et KB925766 (correctif cumulatif d’octobre 2006 pour Windows XP Media Center Edition) installés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible	Windows
En-tête	mfobjects.h (include Mfidl.h)
Bibliothèque	Mfuuid.lib

Voir aussi

Méthodes de rappel asynchrones

IMFAsyncResult