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

メディア ファンデーションの一部のインターフェイスは、QueryInterface を呼び出す代わりに IMFGetService::GetService を呼び出して取得する必要があります。 GetService メソッドは QueryInterface と同様に機能しますが、次の違いがあります。

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

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

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

場合によっては、インターフェイスが 1 つのクラスのオブジェクトによってサービスとして返され、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 インターフェイス

メディア ファンデーション プラットフォーム API