Bagikan melalui

Struktur VIDEOPARAMETERS (tvout.h)

  • Artikel

Driver miniport video menerima penunjuk ke struktur VIDEOPARAMETERS di anggota InputBuffer dari VIDEO_REQUEST_PACKET ketika permintaan IOCTL IOCTL_VIDEO_HANDLE_VIDEOPARAMETERS. Tergantung pada anggota dwCommand dari struktur VIDEOPARAMETERS, driver miniport harus mendapatkan atau mengatur konektor televisi dan kemampuan perlindungan salin perangkat.

Sintaks

typedef struct _VIDEOPARAMETERS {
  GUID  Guid;
  ULONG dwOffset;
  ULONG dwCommand;
  ULONG dwFlags;
  ULONG dwMode;
  ULONG dwTVStandard;
  ULONG dwAvailableModes;
  ULONG dwAvailableTVStandard;
  ULONG dwFlickerFilter;
  ULONG dwOverScanX;
  ULONG dwOverScanY;
  ULONG dwMaxUnscaledX;
  ULONG dwMaxUnscaledY;
  ULONG dwPositionX;
  ULONG dwPositionY;
  ULONG dwBrightness;
  ULONG dwContrast;
  ULONG dwCPType;
  ULONG dwCPCommand;
  ULONG dwCPStandard;
  ULONG dwCPKey;
  ULONG bCP_APSTriggerBits;
  UCHAR bOEMCopyProtection[256];
} VIDEOPARAMETERS, *PVIDEOPARAMETERS, *LPVIDEOPARAMETERS;

Anggota

Guid

Menentukan pengidentifikasi unik global (GUID) untuk struktur ini {02C62061-1097-11d1-920F-00A024DF156E}. Driver miniport video harus memverifikasi GUID di awal struktur sebelum memproses struktur.

dwOffset

Dicadangkan dan harus diabaikan oleh driver miniport video.

dwCommand

Menunjukkan tindakan yang akan dilakukan oleh driver. Anggota ini bisa menjadi salah satu nilai berikut:

VP_COMMAND_GET

Driver miniport harus mengembalikan semua kemampuan konektor TV perangkat, pengaturan konektor TV saat ini, kemampuan perlindungan salin, dan pengaturan perlindungan salin saat ini dengan mengatur bendera yang sesuai di dwFlags dan mengatur nilai anggota yang sesuai dengan bendera yang ditetapkan tersebut.

VP_COMMAND_SET

Driver miniport harus mengatur konektor TV dan perangkat keras perlindungan salinan sesuai dengan anggota struktur ini yang sesuai dengan bendera yang diatur dalam dwFlags.

dwFlags

Menunjukkan anggota struktur ini mana yang berisi data yang valid. Ketika dwCommand VP_COMMAND_GET, driver harus mengatur bit yang sesuai dalam anggota ini untuk menunjukkan di mana anggota yang sesuai telah mengembalikan data yang valid. Ketika dwCommand VP_COMMAND_SET, driver harus mengatur fungsionalitas pada perangkat keras sesuai dengan nilai dalam anggota yang sesuai dengan bit yang ditetapkan dalam anggota ini. Anggota ini bisa menjadi bitwise ATAU dari nilai yang tercantum di kolom pertama tabel berikut ini.

Bendera Anggota Terkait Perintah
VP_FLAGS_BRIGHTNESS dwBrightness get/set
VP_FLAGS_CONTRAST dwContrast get/set
VP_FLAGS_COPYPROTECT dwCPType

dwCPCommand

dwCPStandard

dwCPKey

bCP_APSTriggerBits

bOEMCopyProtection

 get/set

set

get

set

set

get/set
VP_FLAGS_FLICKER dwFlickerFilter get/set
VP_FLAGS_MAX_UNSCALED dwMaxUnscaledX

dwMaxUnscaledY

 get

get
VP_FLAGS_OVERSCAN dwOverscanX

dwOverscanY

 get/set

get/set
VP_FLAGS_POSITION dwPositionX

dwPositionY

 get/set

get/set
VP_FLAGS_TV_MODE dwMode

dwAvailableModes

 get/set

get
VP_FLAGS_TV_STANDARD dwTVStandard

dwAvailableTVStandard

 get/set

get

dwMode

Menentukan mode pemutaran saat ini. Anggota ini berlaku untuk perintah VP_COMMAND_SET dan VP_COMMAND_GET, dan bisa menjadi salah satu nilai berikut:

VP_MODE_TV_PLAYBACK

Menjelaskan serangkaian bidang yang optimal untuk pemutaran video, dengan filter berkedlip mati dan tampilan overscan aktif.

VP_MODE_WIN_GRAPHICS

Menjelaskan pengaturan tampilan yang optimal untuk tampilan Windows, dengan filter berkedlip maksimum aktif dan tampilan overscan dimatikan.

dwTVStandard

Adalah standar televisi dunia saat ini. Anggota ini berlaku untuk perintah VP_COMMAND_SET dan VP_COMMAND_GET, dan bisa menjadi salah satu nilai berikut:

VP_TV_STANDARD_NTSC_M

VP_TV_STANDARD_NTSC_M_J

VP_TV_STANDARD_NTSC_433

VP_TV_STANDARD_PAL_B

VP_TV_STANDARD_PAL_D

VP_TV_STANDARD_PAL_G

VP_TV_STANDARD_PAL_H

VP_TV_STANDARD_PAL_I

VP_TV_STANDARD_PAL_M

VP_TV_STANDARD_PAL_N

VP_TV_STANDARD_PAL_60

VP_TV_STANDARD_SECAM_B

VP_TV_STANDARD_SECAM_D

VP_TV_STANDARD_SECAM_G

VP_TV_STANDARD_SECAM_H

VP_TV_STANDARD_SECAM_K

VP_TV_STANDARD_SECAM_K1

VP_TV_STANDARD_SECAM_L

VP_TV_STANDARD_SECAM_L1

VP_TV_STANDARD_WIN_VGA

dwAvailableModes

Menunjukkan mode pemutaran yang mampu dilakukan perangkat. Anggota ini hanya valid untuk perintah VP_COMMAND_GET, dan bisa menjadi bitwise ATAU dari nilai berikut:

VP_MODE_TV_PLAYBACK

VP_MODE_WIN_GRAPHICS

dwAvailableTVStandard

Menentukan semua standar televisi dunia yang tersedia. Anggota ini hanya valid untuk perintah VP_COMMAND_GET, dan bisa menjadi bitwise ATAU dari nilai berikut:

VP_TV_STANDARD_NTSC_M

VP_TV_STANDARD_NTSC_M_J

VP_TV_STANDARD_NTSC_433

VP_TV_STANDARD_PAL_B

VP_TV_STANDARD_PAL_D

VP_TV_STANDARD_PAL_G

VP_TV_STANDARD_PAL_H

VP_TV_STANDARD_PAL_I

VP_TV_STANDARD_PAL_M

VP_TV_STANDARD_PAL_N

VP_TV_STANDARD_PAL_60

VP_TV_STANDARD_SECAM_B

VP_TV_STANDARD_SECAM_D

VP_TV_STANDARD_SECAM_G

VP_TV_STANDARD_SECAM_H

VP_TV_STANDARD_SECAM_K

VP_TV_STANDARD_SECAM_K1

VP_TV_STANDARD_SECAM_L

VP_TV_STANDARD_SECAM_L1

VP_TV_STANDARD_WIN_VGA

dwFlickerFilter

Adalah nilai dalam persepuluh persen yang menunjukkan status filter kedinginan. Anggota ini bisa menjadi nilai antara [0.1000], dan berlaku untuk VP_COMMAND_GET dan VP_COMMAND_SET.

dwOverScanX

Adalah nilai dalam persepuluh persen yang menunjukkan jumlah overscan dalam x. Anggota ini bisa menjadi nilai antara [0.1000], dan berlaku untuk VP_COMMAND_GET dan VP_COMMAND_SET.

dwOverScanY

Adalah nilai dalam persepuluh persen yang menunjukkan jumlah overscan dalam y. Anggota ini bisa menjadi nilai antara [0.1000], dan berlaku untuk VP_COMMAND_GET dan VP_COMMAND_SET.

dwMaxUnscaledX

Adalah resolusi x maksimum yang dapat ditampilkan TV tanpa menskalakan perangkat keras gambar video. Driver miniport harus menetapkan nilai dalam anggota ini ketika dwCommand VP_COMMAND_GET. Anggota ini tidak valid untuk VP_COMMAND_SET.

dwMaxUnscaledY

Adalah resolusi y maksimum yang dapat ditampilkan TV tanpa menskalakan perangkat keras gambar video. Driver miniport harus menetapkan nilai dalam anggota ini ketika dwCommand VP_COMMAND_GET. Anggota ini tidak valid untuk VP_COMMAND_SET.

dwPositionX

Adalah nilai yang digunakan oleh perangkat keras untuk menentukan posisi x gambar saat ini di TV. Anggota ini ditentukan dalam piksel, dan berlaku untuk VP_COMMAND_GET dan VP_COMMAND_SET.

dwPositionY

Adalah nilai yang digunakan oleh perangkat keras untuk menentukan posisi y gambar saat ini di TV. Anggota ini ditentukan dalam baris pemindaian, dan berlaku untuk VP_COMMAND_GET dan VP_COMMAND_SET.

dwBrightness

Adalah nilai persentase yang menunjukkan pengaturan kecerahan pada TV. Anggota ini bisa menjadi nilai antara [0.100], dan berlaku untuk VP_COMMAND_GET dan VP_COMMAND_SET.

dwContrast

Adalah nilai persentase yang menunjukkan pengaturan kontras pada TV. Anggota ini bisa menjadi nilai antara [0.100], dan berlaku untuk VP_COMMAND_GET dan VP_COMMAND_SET.

dwCPType

Menentukan jenis perlindungan salinan yang didukung oleh perangkat. Anggota ini berlaku untuk perintah VP_COMMAND_SET dan VP_COMMAND_GET, dan dapat CP_TYPE_APS_TRIGGER.

dwCPCommand

Adalah perintah perlindungan salin. Anggota ini hanya valid untuk perintah VP_COMMAND_SET, dan bisa menjadi salah satu nilai berikut:

VP_CP_CMD_ACTIVATE

Driver miniport harus mengaktifkan perlindungan salin dan menghasilkan dan mengembalikan kunci perlindungan salinan unik di dwCPKey.

VP_CP_CMD_CHANGE

Jika kunci perlindungan salin di dwCPKey valid, driver miniport harus mengubah perlindungan salin berdasarkan data pemicu di bCP_APSTriggerBits.

VP_CP_CMD_DEACTIVATE

Jika kunci perlindungan salin di dwCPKey valid, driver miniport harus mematikan perlindungan salin.

dwCPStandard

Adalah standar TV yang jenis perlindungan salinannya tersedia. Anggota ini hanya valid untuk perintah VP_COMMAND_GET, dan bisa menjadi bitwise ATAU dari nilai berikut:

VP_TV_STANDARD_NTSC_M

VP_TV_STANDARD_NTSC_M_J

VP_TV_STANDARD_NTSC_433

VP_TV_STANDARD_PAL_B

VP_TV_STANDARD_PAL_D

VP_TV_STANDARD_PAL_G

VP_TV_STANDARD_PAL_H

VP_TV_STANDARD_PAL_I

VP_TV_STANDARD_PAL_M

VP_TV_STANDARD_PAL_N

VP_TV_STANDARD_PAL_60

VP_TV_STANDARD_SECAM_B

VP_TV_STANDARD_SECAM_D

VP_TV_STANDARD_SECAM_G

VP_TV_STANDARD_SECAM_H

VP_TV_STANDARD_SECAM_K

VP_TV_STANDARD_SECAM_K1

VP_TV_STANDARD_SECAM_L

VP_TV_STANDARD_SECAM_L1

VP_TV_STANDARD_WIN_VGA

dwCPKey

Adalah kunci perlindungan salinan yang dihasilkan driver yang unik untuk instans driver ini. Anggota ini hanya berlaku untuk perintah VP_COMMAND_SET. Driver miniport menghasilkan dan mengembalikan kunci ini ketika dwCPCommand diatur ke VP_CP_CMD_ACTIVATE. Pemanggil harus mengatur kunci ini ketika bidang dwCPCommand VP_CP_CMD_DEACTIVATE atau VP_CP_CMD_CHANGE. Jika penelepon menetapkan kunci yang salah, driver tidak boleh mengubah pengaturan perlindungan salinan saat ini.

bCP_APSTriggerBits

Menentukan data bit pemicu sistem perlindungan analog (APS) DVD. Bit nol dan 1 valid. Anggota ini hanya berlaku untuk perintah VP_COMMAND_SET.

bOEMCopyProtection[256]

Data perlindungan salinan khusus OEM. Anggota ini berlaku untuk perintah VP_COMMAND_SET dan VP_COMMAND_GET.

Persyaratan

Persyaratan Nilai
Header tvout.h (sertakan Tvout.h)

Lihat juga

IOCTL_VIDEO_HANDLE_VIDEOPARAMETERS

VIDEO_REQUEST_PACKET