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é.

Notes

L’interface IMFGetService est très similaire à l’interface IServiceProvider utilisée dans d’autres API.

 

Un 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.

Identificateur de service Interface Objets susceptibles d’exposer ce service
MF_METADATA_PROVIDER_SERVICE IMFMetadataProvider Sources multimédias
MF_MEDIASOURCE_SERVICE IMFMediaSource Pris en charge dans Windows 8.1 et versions ultérieures.
MF_PMP_SERVER_CONTEXT IMFPMPServer Session multimédia PMP (Protected Media Path).
MF_QUALITY_SERVICES IMFQualityAdvise Sources multimédias.
MF_RATE_CONTROL_SERVICE IMFRateControl Sources multimédias, Session multimédia
MF_RATE_CONTROL_SERVICE IMFRateSupport Sources multimédias, récepteurs multimédias, Session multimédia
MF_REMOTE_PROXY IMFRemoteProxy Proxys pour les objets distants.
MF_SAMI_SERVICE IMFSAMIStyle Source multimédia SAMI (Accessible Media Interchange) synchronisée.
MF_SOURCE_PRESENTATION_PROVIDER_SERVICE IMFMediaSourcePresentationProvider Source du séquenceur
MF_TIMECODE_SERVICE IMFTimecodeTranslate Source multimédia ASF.
MF_TOPONODE_ATTRIBUTE_EDITOR_SERVICE IMFTopologyNodeAttributeEditor Session multimédia
MF_WRAPPED_OBJECT IMFByteStream Objets encapsulés
MF_WRAPPED_BUFFER_SERVICE Pris en charge dans Windows 8.1 et versions ultérieures.
MF_WRAPPED_SAMPLE_SERVIC Pris en charge dans Windows 8.1 et versions ultérieures.
MF_WORKQUEUE_SERVICES IMFWorkQueueServices Session multimédia
MFNET_SAVEJOB_SERVICE IMFSaveJob Flux d’octets
MFNETSOURCE_STATISTICS_SERVICE Ipropertystore Source réseau. Utilisez ce service pour récupérer des statistiques réseau. Consultez MFNETSOURCE_STATISTICS, propriété.
MR_AUDIO_POLICY_SERVICE IMFAudioPolicy Convertisseur audio
MR_BUFFER_SERVICE IDirect3DSurface9 Mémoires tampons de surface DirectX
MR_CAPTURE_POLICY_VOLUME_SERVICE IMFSimpleAudioVolume Source de capture audio
MR_POLICY_VOLUME_SERVICE IMFSimpleAudioVolume Convertisseur audio
MR_STREAM_VOLUME_SERVICE IMFAudioStreamVolume Convertisseur audio
MR_VIDEO_ACCELERATION_SERVICE IDirect3DDeviceManager9, IDirectXVideoAccelerationService Convertisseur vidéo amélioré (EVR)
MR_VIDEO_ACCELERATION_SERVICE IDirectXVideoMemoryConfiguration Broches d’entrée sur le filtre EVR DirectShow
MR_VIDEO_ACCELERATION_SERVICE IMFVideoSampleAllocator Interface Récepteurs de flux EVR.
MR_VIDEO_MIXER_SERVICE Différentes interfaces exposées par le mélangeur EVR. Consultez Utilisation des contrôles de mixage vidéo. EVR
MR_VIDEO_RENDER_SERVICE Différentes interfaces exposées par le présentateur EVR. Consultez Utilisation des contrôles d’affichage vidéo. EVR

 

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 renvoyée par une autre classe d’objets via QueryInterface . Les pages de référence de chaque interface indiquent quand utiliser GetService et quand utiliser QueryInterface.

Attention

Un objet peut être implémenté de telle sorte qu’il retourne une interface de service via QueryInterface et GetService. Toutefois, l’utilisation de QueryInterface lorsque GetService est requis peut entraîner des problèmes de compatibilité ultérieurement.

 

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

IMFGetService, interface

API Media Foundation Platform