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

非同期 の Begin メソッドで呼び出し元によって指定された状態オブジェクトを返します。

構文

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

[out] ppunkState

状態オブジェクトの IUnknown インターフェイスへのポインターを受け取ります。値が NULL でない場合、呼び出し元はインターフェイスを解放する必要があります。

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

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

非同期メソッドの呼び出し元は状態オブジェクトを指定し、呼び出し元が定義した目的で使用できます。状態オブジェクトは NULL にすることができます。状態オブジェクトが NULL の場合、 GetState は E_POINTERを返します。

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

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

Windows XP Service Pack 2 (SP2) 以降。
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