サービス インターフェイス

Media Foundation の一部のインターフェイスは、QueryInterface 呼び出す代わりに、IMFGetService::GetService を呼び出して取得する必要があります。 GetService メソッドは QueryInterface と同様に動作しますが、次の違いがあります。

• インターフェイス識別子に加えて、サービス識別子 GUID を受け取ります。
• 照会された元のオブジェクトへのポインターを返す代わりに、インターフェイスを実装する別のオブジェクトへのポインターを返すことができます。

サービス は、IMFGetService インターフェイスを介してオブジェクトの特定のクラスから取得された特定のインターフェイスです。 次のサービスが定義されています。

GetService を使用して、この表に示すオブジェクトからこの表に示されているインターフェイスを取得する必要があります。

場合によっては、インターフェイスは、あるクラスのオブジェクトによってサービスとして返され、別のクラスのオブジェクトによって QueryInterface を介して返されます。 各インターフェイスの参照ページは、GetService を使用するタイミングと、QueryInterfaceを使用するタイミングを示します。

MFGetService 関数は、IMFGetServiceのオブジェクトクエリを実行し、オブジェクトの GetService メソッドを呼び出すヘルパー関数です。

例

次の例では、メディア セッション IMFGetService を照会し、IMFRateControl インターフェイスを取得します。

IMFGetService *pGetService = NULL;
IMFRateControl *pRateControl = NULL;
HRESULT hr = S_OK;

hr = pMediaSession->QueryInterface(
    IID_IMFGetService, 
    (void**)&pGetService);

if (SUCCEEDED(hr))
{
    hr = pGetService->GetService(
        MF_RATE_CONTROL_SERVICE, 
        IID_IMFRateControl,
        (void**)&pRateControl);
}
if (SUCCEEDED(hr))
{
    // Use IMFRateControl. (Not shown.)
}

// Clean up.
SAFE_REELEASE(pGetService);
SAFE_RELEASE(pRateControl);

次の例は前の例と同じですが、MFGetService 関数を使用します。

IMFRateControl *pRateControl = NULL;
HRESULT hr = S_OK;

hr = MFGetService(
    pMediaSession, 
    MF_RATE_CONTROL_SERVICE, 
    IID_IMFRateControl, 
    (void**) &pRateCtl 
); 
if (SUCCEEDED(hr))
{
    // Use IMFRateControl. (Not shown.)
}

// Clean up.
SAFE_RELEASE(pRateControl);

関連トピック

IMFGetService インターフェイスの

Media Foundation Platform API