PDD_VPORTCB_GETINPUTFORMATS fungsi panggilan balik (ddrawint.h)

Artikel
08/23/2023

Fungsi panggilan balik DdVideoPortGetInputFormats menentukan format input yang dapat diterima objek VPE DirectDraw.

Sintaks

PDD_VPORTCB_GETINPUTFORMATS PddVportcbGetinputformats;

DWORD PddVportcbGetinputformats(
  PDD_GETVPORTINPUTFORMATDATA unnamedParam1
)
{...}

Parameter

unnamedParam1

Menunjuk ke struktur DD_GETVPORTINPUTFORMATDATA yang berisi informasi yang diperlukan driver untuk mengembalikan format input yang dapat diterima objek VPE.

Menampilkan nilai

DdVideoPortGetInputFormats mengembalikan salah satu kode panggilan balik berikut:

Keterangan

DdVideoPortGetInputFormats harus diimplementasikan di driver DirectDraw yang mendukung VPE.

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

Dalam panggilan pertama, anggota lpddpfFormat dari struktur DD_GETVPORTINPUTFORMATDATA di lpGetInputFormats adalah NULL. Driver harus menulis jumlah format input yang didukung objek VPE di anggota dwNumFormats dari DD_GETVPORTINPUTFORMATDATA. Setelah kembali, DirectDraw akan mengalokasikan jumlah struktur DDPIXELFORMAT ini untuk diteruskan dalam panggilan kedua ke DdVideoPortGetInputFormats.
Dalam panggilan kedua, lpddpfFormat menunjuk ke array struktur DDPIXELFORMAT yang dialokasikan. Driver harus mengisi setiap struktur untuk menjelaskan setiap format input yang didukung objek VPE. Driver juga harus mengembalikan jumlah format input yang didukung dalam dwNumFormats. Perhatikan bahwa driver dijamin bahwa buffer tempat titik lpddpfFormat cukup besar untuk menyimpan informasi format yang diminta.

Jika anggota dwFlags dari struktur DD_GETVPORTINPUTFORMATDATA diatur hanya ke DDVPFORMAT_VIDEO, driver hanya boleh mengembalikan format 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_GETVPORTINPUTFORMATDATA

Bagikan melalui