Dienstschnittstellen

  • Artikel

Einige Schnittstellen in Media Foundation müssen durch Aufrufen von IMFGetService::GetService statt durch Aufrufen von QueryInterface abgerufen werden. Die GetService-Methode funktioniert wie QueryInterface, jedoch mit den folgenden Unterschieden:

  • Zusätzlich zur Schnittstellenkennung wird eine Dienst-ID-GUID verwendet.
  • Sie kann einen Zeiger auf ein anderes Objekt zurücksenden, das die Schnittstelle implementiert, anstatt einen Zeiger auf das ursprüngliche Objekt zurückzusenden, das abgefragt wird.

Hinweis

Die IMFGetService-Schnittstelle ist der in einigen anderen APIs verwendeten IServiceProvider-Schnittstelle sehr ähnlich.

 

Ein Dienst ist eine bestimmte Schnittstelle, die von einer bestimmten Klasse von Objekten über die IMFGetService-Schnittstelle abgerufen wird. Die folgenden Dienste werden definiert.

Dienstbezeichner Schnittstelle Objekte, die diesen Dienst möglicherweise verfügbar machen
MF_METADATA_PROVIDER_SERVICE IMFMetadataProvider Medienquellen
MF_MEDIASOURCE_SERVICE IMFMediaSource Unterstützt in Windows 8.1 und höher.
MF_PMP_SERVER_CONTEXT IMFPMPServer Geschützte Medienpfad (PMP)-Mediensitzung.
MF_QUALITY_SERVICES IMFQualityAdvise Medienquellen.
MF_RATE_CONTROL_SERVICE IMFRateControl Medienquellen, Mediensitzung
MF_RATE_CONTROL_SERVICE IMFRateSupport Medienquellen, Mediensenken, Mediensitzung
MF_REMOTE_PROXY IMFRemoteProxy Proxys für Remoteobjekte.
MF_SAMI_SERVICE IMFSAMIStyle Synchronisierte Medienquelle mit Zugriff für Medienaustausch (SAMI) Medienquelle.
MF_SOURCE_PRESENTATION_PROVIDER_SERVICE IMFMediaSourcePresentationProvider Sequencer-Quelle
MF_TIMECODE_SERVICE IMFTimecodeTranslate ASF-Medienquelle.
MF_TOPONODE_ATTRIBUTE_EDITOR_SERVICE IMFTopologyNodeAttributeEditor Mediensitzung
MF_WRAPPED_OBJECT IMFByteStream Verpackte Objekte
MF_WRAPPED_BUFFER_SERVICE Unterstützt in Windows 8.1 und höher.
MF_WRAPPED_SAMPLE_SERVIC Unterstützt in Windows 8.1 und höher.
MF_WORKQUEUE_SERVICES IMFWorkQueueServices Mediensitzung
MFNET_SAVEJOB_SERVICE IMFSaveJob Byte-Streams
MFNETSOURCE_STATISTICS_SERVICE IPropertyStore Netzwerkquelle. Verwenden Sie diesen Dienst, um Netzwerkstatistiken abzurufen. Siehe MFNETSOURCE_STATISTICS-Eigenschaft.
MR_AUDIO_POLICY_SERVICE IMFAudioPolicy Audiorenderer
MR_BUFFER_SERVICE IDirect3DSurface9 DirectX Oberflächen-Puffer
MR_CAPTURE_POLICY_VOLUME_SERVICE IMFSimpleAudioVolume Audio Capture einbinden
MR_POLICY_VOLUME_SERVICE IMFSimpleAudioVolume Audiorenderer
MR_STREAM_VOLUME_SERVICE IMFAudioStreamVolume Audiorenderer
MR_VIDEO_ACCELERATION_SERVICE IDirect3DDeviceManager9, IDirectXVideoAccelerationService Verbesserter Videorenderer (EVR)
MR_VIDEO_ACCELERATION_SERVICE IDirectXVideoMemoryConfiguration Eingabestecknadeln im ActiveMovie EVR-Filter
MR_VIDEO_ACCELERATION_SERVICE IMFVideoSampleAllocator-Schnittstelle EVR-Streamsenken.
MR_VIDEO_MIXER_SERVICE Verschiedene Schnittstellen, die vom EVR-Mixer verfügbar gemacht werden. Siehe Verwenden der Videomixersteuerelemente. EVR
MR_VIDEO_RENDER_SERVICE Verschiedene Schnittstellen, die vom EVR-Referent verfügbar gemacht werden. Siehe Verwenden der Videoanzeigesteuerelemente. EVR
MF_ACOUSTIC_ECHO_CANCELLATION_CONTROL_SERVICE IAcousticEchoCancellationControl AEC-Effekte (Akustisches Echo abbrechen). Eingeführt in Windows 11, Version 24H2.
MF_AUDIO_EFFECTS_MANAGER_SERVICE IAudioEffectsManager Medienquellen. Eingeführt in Windows 11, Version 24H2.

 

Sie müssen GetService verwenden, um die in dieser Tabelle aufgeführten Schnittstellen aus den in dieser Tabelle aufgeführten Objekten abzurufen.

In einigen Fällen wird eine Schnittstelle als Dienst von einer Klasse von Objekten zurückgegeben und von einer anderen Objektklasse durch QueryInterface zurückgegeben. Die Referenzseiten für jede Schnittstelle geben an, wann GetService und wann QueryInterface verwendet werden soll.

Achtung

Ein Objekt kann so implementiert werden, dass es eine Dienstschnittstelle über QueryInterface sowie GetService zurückgibt. Die Verwendung von QueryInterface, wenn GetService erforderlich ist, kann jedoch später zu Kompatibilitätsproblemen führen.

 

Die MFGetService-Funktion ist eine Hilfsfunktion, die ein Objekt für IMFGetService abfragt und dann die GetService-Methode des Objekts aufruft.

Beispiele

Das folgende Beispiel fragt die Mediensitzung für IMFGetService ab und ruft die IMFRateControl- Schnittstelle ab.

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

Das folgende Beispiel entspricht dem vorherigen Beispiel, aber nutzt die Funktion 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-Schnittstelle

Media Foundation-Plattform-APIs