MFGetService 関数 (mfidl.h)

指定したサービスインターフェイスのオブジェクトに対してクエリを実行します。

この関数は、 IMFGetService::GetService メソッドをラップするヘルパー関数です。関数はオブジェクトに対して IMFGetService インターフェイスのクエリを実行し、成功した場合はオブジェクトに対 して GetService を呼び出します。

構文

HRESULT MFGetService(
  IUnknown *punkObject,
  REFGUID  guidService,
  REFIID   riid,
  LPVOID   *ppvObject
);

punkObject

クエリを実行するオブジェクトの IUnknown インターフェイスへのポインター。

guidService

サービスのサービス識別子 (SID)。サービス識別子の一覧については、「サービスインターフェイス」を参照してください。

riid

要求されているインターフェイスのインターフェイス識別子 (IID)。

ppvObject

インターフェイスポインターを受け取ります。呼び出し元はインターフェイスを解放する必要があります。

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

リターンコード	説明
S_OK	メソッドが成功しました。
MF_E_UNSUPPORTED_SERVICE	要求されたサービスが punkObject で表されるオブジェクトに見つかりません。

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	mfidl.h
Library	Mf.lib
[DLL]	Mf.dll