Dienstschnittstellen

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.

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

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.

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

Zugehörige Themen

IMFGetService-Schnittstelle

Media Foundation-Plattform-APIs