IMFAsyncResult::GetObject メソッド (mfobjects.h)

非同期操作に関連付けられているオブジェクトを返します。オブジェクトの型 (存在する場合) は、呼び出された非同期メソッドによって異なります。

構文

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

[out] ppObject

オブジェクトの IUnknown インターフェイスへのポインターを受け取ります。操作に関連付けられているオブジェクトがない場合、このパラメーターは値 NULL を受け取ります。値が NULL でない場合、呼び出し元はインターフェイスを解放する必要があります。

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード	説明
S_OK	メソッドが成功しました。
E_POINTER	この非同期結果に関連付けられているオブジェクトはありません。

通常、このオブジェクトは非同期メソッドを実装するコンポーネントによって使用されます。コールバックを呼び出す関数が、操作を完了する非同期 End.... メソッドに情報を渡す方法を提供します。

非同期メソッドを実装する場合は、MFCreateAsyncResult 関数の punkObject パラメーターを使用してオブジェクトを設定できます。

非同期結果オブジェクトの内部 IUnknown ポインターが NULL の場合、メソッドは E_POINTERを返します。

このインターフェイスは、Windows Media Format 11 SDK 再頒布可能コンポーネントがインストールされている場合、次のプラットフォームで使用できます。

Service Pack 2 (SP2) 以降の Windows XP。
Windows XP Media Center Edition 2005 と KB900325 (Windows XP Media Center Edition 2005) とKB925766 (2006 年 10 月 Windows XP Media Center Edition の更新プログラムのロールアップ) がインストールされています。

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	mfobjects.h (Mfidl.h を含む)
Library	Mfuuid.lib