IRegisterServiceProvider

IRegisterServiceProvider インターフェースは、オブジェクトをサービスとして Filter Graph Manager に登録します。詳細については、IRegisterServiceProvider::RegisterService を参照してください。

RegisterService メソッドは、オブジェクトをサービスとして登録します。

HRESULT 値を返します。

サービスとは、クライアントが通常の IUnknown::QueryInterface メソッドではなく、COM の IServiceProvider::QueryService メソッドを通じて検出するインターフェースです。この 2 つのメソッドの違いは、QueryInterface が元のオブジェクトのインターフェースを返すのに対し、QueryService は別のオブジェクトのインターフェースを返す場合があるという点です。(より正確には、QueryInterface は元のインターフェースと返されたインターフェースに対して IUnknown を照会でき、同一のポインターが返されることが保証されます。QueryService にはこの保証はありません。)

RegisterService メソッドを使用すると、サービスを Filter Graph Manager に登録できます。これにより、他のオブジェクトは IServiceProvider インターフェースを使用してあなたのオブジェクトを取得できるようになります。Filter Graph Manager を中心的な通信ポイントとして利用することで、個別の COM オブジェクト間の通信が容易になります。

サービスは、サービス識別子 (SID) と呼ばれる GUID によって識別されます。1 つのサービスは複数のインターフェースをサポートできます。サービスを登録するには、次のコードに示すように RegisterService を呼び出します。

DEFINE_GUID(SID_MyService, ....);
IRegisterServiceProvider *pRSP;
hr = pGraph->QueryInterface(IID_IRegisterServiceProvider, (void**)&pRSP);
if (SUCCEEDED(hr))
{
    IUnknown pServiceObj;
    MyCreateServiceHelper(SID_MyService, &pServiceObj);
    pRSP->RegisterService(SID_MyService, pServiceObj);
    pRSP->Release();
    pServiceObj->Release();
}

IServiceProvider *pSP;
hr = pGraph->QueryInterface(IID_IServiceProvider, (void**)&pSP);
if (SUCCEEDED(hr))
{
    ISomeInterface *pService;
    hr = pSP->QueryService(SID_MyService, IID_ISomeInterface, (void**)&pService);
    pSP->Release();
    if (SUCCEEDED(hr))
    {
        pService->SomeMethod();
        pService->Release();
    }
};

pRSP->RegisterService(SID_MyService, NULL);

Filter Graph Manager は、サービスの登録が解除されるまでサービスオブジェクトの参照カウントを保持します。循環参照カウントを防ぐため、サービスオブジェクトは Filter Graph Manager の参照カウントを保持すべきではありません。たとえば、サービスオブジェクトのデストラクターメソッドを使用してサービスの登録を解除することはできません。サービスが Filter Graph Manager の参照カウントを保持している限り、デストラクターが呼び出されることは決してないためです。1 つの解決策は、サービスの登録と登録解除を行う別のオブジェクトを作成することです。あるいは、サービスを登録した後は単純にサービスオブジェクトを解放し、その有効期間を Filter Graph Manager に管理させることもできます。