Partager via


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