Интерфейсы служб

Некоторые интерфейсы в Media Foundation должны быть получены путем вызова МВФGetService::GetService вместо вызова QueryInterface. Метод GetService работает так же, как QueryInterface, но со следующими различиями:

• Он принимает guid идентификатора службы в дополнение к идентификатору интерфейса.
• Он может возвращать указатель на другой объект, реализующий интерфейс, а не возвращать указатель на исходный объект, запрашиваемый.

Служба — это определенный интерфейс, полученный из определенного класса объектов через интерфейс МВФGetService. Определены следующие службы.

Для получения интерфейсов, перечисленных в этой таблице, необходимо использовать GetService из объектов, перечисленных в этой таблице.

В некоторых случаях интерфейс возвращается в качестве службы одним классом объектов и возвращается через QueryInterface другим классом объектов. Справочные страницы для каждого интерфейса указывают, когда следует использовать GetService и когда использовать QueryInterface.

Функция MFGetService является вспомогательной функцией, которая запрашивает объект для МВФGetService, а затем вызывает метод GetService объекта.

Примеры

В следующем примере выполняется запрос сеанса мультимедиа для МВФGetService и возвращается интерфейс 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);

Следующий пример эквивалентен предыдущему примеру, но использует функцию 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

API платформы Media Foundation