PDD_VPORTCB_GETOUTPUTFORMATS fungsi panggilan balik (ddrawint.h)

Artikel
08/23/2023

Fungsi panggilan balik DdVideoPortGetOutputFormats menentukan format output yang didukung objek VPE.

Sintaks

PDD_VPORTCB_GETOUTPUTFORMATS PddVportcbGetoutputformats;

DWORD PddVportcbGetoutputformats(
  PDD_GETVPORTOUTPUTFORMATDATA unnamedParam1
)
{...}

Parameter

unnamedParam1

Menunjuk ke struktur DD_GETVPORTOUTPUTFORMATDATA yang berisi informasi yang diperlukan driver untuk mengembalikan format output yang didukung objek VPE.

Menampilkan nilai

DdVideoPortGetOutputFormats mengembalikan salah satu kode panggilan balik berikut:

Keterangan

Driver DirectDraw yang mendukung VPE harus menerapkan DdVideoPortGetOutputFormats

DirectDraw memanggil DdVideoPortGetOutputFormats untuk mendapatkan jumlah format output yang didukung oleh objek VPE yang ditentukan dan deskripsi setiap format. DdVideoPortGetOutputFormats dipanggil dua kali untuk objek VPE yang ditentukan:

Dalam panggilan pertama, anggota lpddpfOutputFormats dari struktur DD_GETVPORTOUTPUTFORMATDATA di lpGetOutputFormats adalah NULL. Driver harus menulis jumlah format output yang didukung objek VPE di anggota dwNumFormats dari DD_GETVPORTOUTPUTFORMATDATA. Setelah kembali, DirectDraw akan mengalokasikan jumlah struktur DDPIXELFORMAT ini untuk meneruskan panggilan kedua ke DdVideoPortGetOutputFormats.
Dalam panggilan kedua, lpddpfOutputFormats menunjuk ke array struktur DDPIXELFORMAT yang dialokasikan. Driver harus mengisi setiap struktur dengan deskripsi setiap format output yang dapat ditulis objek VPE ke buffer bingkai. Driver hanya boleh mengembalikan format output yang didukungnya berdasarkan format input data video. Driver juga harus mengembalikan jumlah format output yang didukung dalam dwNumFormats. Perhatikan bahwa driver dijamin bahwa buffer tempat titik lpddpfOutputFormats cukup besar untuk menyimpan informasi format yang diminta.

Jika anggota dwFlags DD_GETVPORTOUTPUTFORMATDATA diatur hanya ke DDVPFORMAT_VIDEO, driver hanya boleh mengembalikan format output yang didukung untuk data video normal. Jika dwFlags diatur hanya ke DDVPFORMAT_VBI, driver hanya boleh mengembalikan format yang didukung untuk data VBI . Jika dwFlags diatur ke kedua bendera, driver harus mengembalikan semua format yang didukung oleh objek VPE .

Persyaratan


Target Platform	Desktop
Header	ddrawint.h (termasuk Winddi.h)

Lihat juga

DDPIXELFORMAT

DD_GETVPORTOUTPUTFORMATDATA

Bagikan melalui