Interfacce di servizio

Alcune interfacce in Media Foundation devono essere ottenute chiamando IMFGetService::GetService anziché chiamando QueryInterface. Il metodoGetServicefunziona come QueryInterface, ma con le differenze seguenti:

• Accetta un GUID dell'identificatore del servizio oltre all'identificatore di interfaccia.
• Può restituire un puntatore a un altro oggetto che implementa l'interfaccia, anziché restituire un puntatore all'oggetto originale su cui viene eseguita una query.

Un servizio è una particolare interfaccia ottenuta da una particolare classe di oggetti tramite l'interfaccia IMFGetService. Sono definiti i servizi seguenti.

È necessario usare GetService per ottenere le interfacce elencate in questa tabella dagli oggetti elencati in questa tabella.

In alcuni casi, un'interfaccia viene restituita come servizio da una classe di oggetti e restituita tramite QueryInterface da un'altra classe di oggetti. Le pagine di riferimento per ogni interfaccia indicano quando usare GetService e quando usare QueryInterface.

La funzioneMFGetServiceè una funzione helper che esegue una query su un oggetto per IMFGetService e quindi chiama il metodo GetService GetService dell'oggetto.

Esempi

Nell'esempio seguente viene richiesta la sessione multimediale per IMFGetService e viene recuperata l'interfacciaIMFRateControl.

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);

L'esempio seguente equivale all'esempio precedente, ma usa la funzioneMFGetService.

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);

Argomenti correlati

interfaccia IMFGetService

MEDIA Foundation Platform