Поделиться через


Метод IDDrawExclModeVideo::SetDDrawSurface (strmif.h)

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Метод SetDDrawSurface задает поверхность DirectDraw, которая будет использоваться при последующем рисовании.

Синтаксис

HRESULT SetDDrawSurface(
  [in] IDirectDrawSurface *pDDrawSurface
);

Параметры

[in] pDDrawSurface

Указатель на интерфейс IDirectDrawSurface на используемой поверхности.

Возвращаемое значение

Возвращает значение HRESULT , которое зависит от реализации интерфейса.

Текущие возвращаемые значения реализации DirectShow включают следующие.

Возвращаемое значение Описание
S_OK
Успешно.
E_INVALIDARG
Аргумент недопустим.
Код ошибки DirectDraw
Ошибка DirectDraw возникает при попытке задать указанную поверхность в микшере наложения.

Комментарии

Игровое приложение может использовать его для предоставления общего доступа к своей поверхности DirectDraw с фильтром Overlay Mixer , чтобы видео можно было отрисовать на указанной поверхности. Эта поверхность должна быть связана с объектом, указанным в IDDrawExclModeVideo::SetDDrawObject.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header strmif.h (включая Dshow.h)
Библиотека Strmiids.lib

См. также раздел

Коды ошибок и успешности

Интерфейс IDDrawExclModeVideo