структура DD_UPDATEVPORTDATA (ddrawint.h)

Структура DD_UPDATEVPORTDATA содержит сведения, необходимые для запуска, остановки и изменения объекта расширений видеопорта (VPE).

Синтаксис

typedef struct _DD_UPDATEVPORTDATA {
  PDD_DIRECTDRAW_LOCAL lpDD;
  PDD_VIDEOPORT_LOCAL  lpVideoPort;
  PDD_SURFACE_INT      *lplpDDSurface;
  PDD_SURFACE_INT      *lplpDDVBISurface;
  PDD_VIDEOPORTINFO    lpVideoInfo;
  DWORD                dwFlags;
  DWORD                dwNumAutoflip;
  DWORD                dwNumVBIAutoflip;
  HRESULT              ddRVal;
  VOID                 *UpdateVideoPort;
} *PDD_UPDATEVPORTDATA, DD_UPDATEVPORTDATA;

Члены

lpDD

Указывает на DD_DIRECTDRAW_LOCAL структуру, которая относится только к текущему процессу Microsoft DirectDraw.

lpVideoPort

Указывает на DD_VIDEOPORT_LOCAL структуру, представляющую этот объект VPE.

lplpDDSurface

Указывает на массив DD_SURFACE_INT структур, представляющих обычные поверхности видео. Этот элемент может иметь значение NULL.

lplpDDVBISurface

Указывает на массив DD_SURFACE_INT структур, представляющих поверхности VBI . Этот элемент может иметь значение NULL.

lpVideoInfo

Указывает на структуру DDVIDEOPORTINFO , которая описывает, как объект VPE должен передавать видеоданные на поверхность. Этот элемент может иметь значение NULL , если dwFlags DDRAWI_VPORTSTOP.

dwFlags

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

Flag	Значение
DDRAWI_VPORTSTART	Драйвер должен запустить поток данных через объект VPE.
DDRAWI_VPORTSTOP	Драйвер должен остановить поток данных через объект VPE.
DDRAWI_VPORTUPDATE	DdVideoPortUpdate был вызван с новым набором флагов в элементе dwVPFlags структуры DDVIDEOPORTINFO, на которую указывает lpVideoInfo . Драйвер должен изменить поток данных через объект VPE в соответствии с новыми флагами.

dwNumAutoflip

Указывает количество поверхностей в списке, на которые указывает lplpDDSurface . Если этот элемент больше 1, lplpDDSurface — это массив поверхностных структур для размещения автоподбора.

dwNumVBIAutoflip

Указывает количество поверхностей в списке, на которые указывает lplpDDVBISurface . Если этот элемент больше 1, то lplpDDVBISurface — это массив поверхностных структур для размещения автоматического скольжения данных VBI .

ddRVal

Указывает расположение, в которое драйвер записывает возвращаемое значение обратного вызова DdVideoPortUpdate . Код возврата DD_OK указывает на успешное выполнение. Дополнительные сведения см. в разделе Возвращаемые значения для DirectDraw.

UpdateVideoPort

Используется API DirectDraw и не должен заполняться драйвером.

Требования

Требование	Значение
Заголовок	ddrawint.h (включая Winddi.h)

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

DDVIDEOPORTINFO

DdVideoPortUpdate