Interfaces de service

Certaines interfaces de 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 renvoyer un pointeur vers un autre objet qui implémente l’interface, au lieu de renvoyer un pointeur vers l’objet d’origine interrogé.

Un service est une interface particulière obtenue à partir d’une classe d’objets particulière 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 qui y sont également répertoriés.

Dans certains cas, une interface est renvoyée en tant que service par une classe d’objets et retournée via 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 GetService de l’objet.

Exemples

L’exemple suivant interroge la session multimédia 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 est équivalent à l’exemple précédent, mais utilise la fonction 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);

Rubriques connexes

IMFGetService Interface

API de plateforme Media Foundation