struktur DD_UPDATEVPORTDATA (ddrawint.h)

Struktur DD_UPDATEVPORTDATA berisi informasi yang diperlukan untuk memulai, menghentikan, dan mengubah objek ekstensi port video (VPE ).

Sintaks

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;

Anggota

lpDD

Menunjuk ke struktur DD_DIRECTDRAW_LOCAL yang relevan dengan proses Microsoft DirectDraw saat ini saja.

lpVideoPort

Menunjuk ke struktur DD_VIDEOPORT_LOCAL yang mewakili objek VPE ini.

lplpDDSurface

Menunjuk ke array struktur DD_SURFACE_INT yang mewakili permukaan video reguler. Anggota ini bisa NULL.

lplpDDVBISurface

Menunjuk ke array struktur DD_SURFACE_INT yang mewakili permukaan VBI . Anggota ini bisa NULL.

lpVideoInfo

Menunjuk ke struktur DDVIDEOPORTINFO yang menjelaskan bagaimana objek VPE harus mentransfer data video ke permukaan. Anggota ini bisa NULL ketika dwFlags DDRAWI_VPORTSTOP.

dwFlags

Menunjukkan tindakan yang akan dilakukan oleh objek VPE. Anggota ini harus menjadi salah satu nilai berikut:

Bendera	Makna
DDRAWI_VPORTSTART	Driver harus memulai aliran data melalui objek VPE.
DDRAWI_VPORTSTOP	Driver harus menghentikan aliran data melalui objek VPE.
DDRAWI_VPORTUPDATE	DdVideoPortUpdate telah dipanggil dengan serangkaian bendera baru di anggota dwVPFlags dari struktur DDVIDEOPORTINFO tempat lpVideoInfo menunjuk. Driver harus mengubah aliran data melalui objek VPE sesuai dengan bendera baru.

dwNumAutoflip

Menentukan jumlah permukaan dalam daftar tempat lplpDDDSurface menunjuk . Jika anggota ini lebih besar dari 1, lplpDDSurface adalah array struktur permukaan untuk mengakomodasi autoflipping.

dwNumVBIAutoflip

Menentukan jumlah permukaan dalam daftar tempat lplpDDVBISurface menunjuk . Jika anggota ini lebih besar dari 1, lplpDDVBISurface adalah array struktur permukaan untuk mengakomodasi autoflipping data VBI .

ddRVal

Menentukan lokasi di mana driver menulis nilai pengembalian dari panggilan balik DdVideoPortUpdate . Kode pengembalian DD_OK menunjukkan keberhasilan. Untuk informasi selengkapnya, lihat Mengembalikan Nilai untuk DirectDraw.

UpdateVideoPort

Digunakan oleh API DirectDraw dan tidak boleh diisi oleh driver.

Persyaratan

Persyaratan	Nilai
Header	ddrawint.h (termasuk Winddi.h)

Lihat juga

DDVIDEOPORTINFO

DdVideoPortUpdate