Service Interfaces

Certaines interfaces dans Media Foundation doivent être obtenues en appelant IMFGetService ::GetService au lieu d’appeler QueryInterface. La méthode GetService fonctionne comme QueryInterface, mais avec les différences suivantes :

• Il prend un GUID d’identificateur de service en plus de l’identificateur d’interface.
• Il peut retourner un pointeur vers un autre objet qui implémente l’interface, au lieu de renvoyer un pointeur vers l’objet d’origine interrogé.

Un de service est une interface particulière obtenue à partir d’une classe particulière d’objets via l’interface IMFGetService. Les services suivants sont définis.

Vous devez utiliser GetService pour obtenir les interfaces répertoriées dans ce tableau à partir des objets répertoriés dans ce tableau.

Dans certains cas, une interface est retournée en tant que service par une classe d’objets et retournée par QueryInterface par une autre classe d’objets. Les pages de référence de chaque interface indiquent quand utiliser GetService et quand utiliser QueryInterface .

La fonction MFGetService est une fonction d’assistance qui interroge un objet pour IMFGetService, puis appelle la méthode GetServicede l’objet.

Exemples

L’exemple suivant interroge la session media pour IMFGetService et obtient l’interface 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);

L’exemple suivant équivaut à l’exemple précédent, mais utilise la fonctionMFGetService.

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

Rubriques connexes

de l’interface IMFGetService

API Media Foundation Platform