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) |