Dienstschnittstellen

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

• Zusätzlich zur Schnittstellen-ID wird eine Dienst-ID-GUID verwendet.
• Es kann einen Zeiger auf ein anderes Objekt zurückgeben, das die Schnittstelle implementiert, anstatt einen Zeiger auf das ursprüngliche Objekt zurückzugeben, 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 von einer Objektklasse als Dienst zurückgegeben und durch QueryInterface- von einer anderen Objektklasse 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, verwendet jedoch 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);

Verwandte Themen

IMFGetService-Schnittstelle

Media Foundation Platform-APIs