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

функция обратного вызова PDD_VPORTCB_GETINPUTFORMATS (ddrawint.h)

  • Статья

Функция обратного вызова DdVideoPortGetInputFormats определяет форматы ввода, которые может принимать объект DirectDraw VPE.

Синтаксис

PDD_VPORTCB_GETINPUTFORMATS PddVportcbGetinputformats;

DWORD PddVportcbGetinputformats(
  PDD_GETVPORTINPUTFORMATDATA unnamedParam1
)
{...}

Параметры

unnamedParam1

Указывает на структуру DD_GETVPORTINPUTFORMATDATA , содержащую сведения, необходимые драйверу для возврата входных форматов, которые может принимать объект VPE.

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

DdVideoPortGetInputFormats возвращает один из следующих кодов обратного вызова:

Комментарии

DdVideoPortGetInputFormats необходимо реализовать в драйверах DirectDraw, поддерживающих VPE.

DirectDraw вызывает DdVideoPortGetInputFormats , чтобы получить количество входных форматов, поддерживаемых указанным объектом VPE, и описание каждого формата. DdVideoPortGetInputFormats вызывается дважды для указанного объекта VPE:

  • В первом вызове элемент lpddpfFormat структуры DD_GETVPORTINPUTFORMATDATA в lpGetInputFormats имеет значение NULL. Драйвер должен записать число входных форматов, поддерживаемых объектом VPE в элементе dwNumFormats DD_GETVPORTINPUTFORMATDATA. После возврата DirectDraw выделяет это количество структур DDPIXELFORMAT для передачи во втором вызове DdVideoPortGetInputFormats.
  • Во втором вызове lpddpfFormat указывает на массив выделенных структур DDPIXELFORMAT. Драйвер должен заполнить каждую структуру, чтобы описать каждый формат входных данных, поддерживаемый объектом VPE. Драйвер также должен возвращать количество поддерживаемых форматов входных данных в dwNumFormats. Обратите внимание, что драйвер гарантирует, что буфер, в который находятся точки lpddpfFormat , достаточно велик для хранения запрашиваемых сведений о формате.
Если для элемента dwFlags структуры DD_GETVPORTINPUTFORMATDATA задано только значение DDVPFORMAT_VIDEO, драйвер должен возвращать только те форматы, которые поддерживаются для обычных видеоданных. Если параметру dwFlags присвоено только значение DDVPFORMAT_VBI, драйвер должен возвращать только те форматы, которые поддерживаются для данных VBI . Если для dwFlags заданы оба флага, драйвер должен возвращать все форматы, поддерживаемые объектом VPE.

Требования

   
Целевая платформа Персональный компьютер
Верхняя часть ddrawint.h (включая Winddi.h)

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

DDPIXELFORMAT

DD_GETVPORTINPUTFORMATDATA