perintah MCI_SETVIDEO

Artikel
06/13/2023

Perintah MCI_SETVIDEO menetapkan nilai yang terkait dengan pemutaran video. Perangkat digital-video dan VCR mengenali perintah ini.

Untuk mengirim perintah ini, panggil fungsi mciSendCommand dengan parameter berikut.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SETVIDEO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpSetVideo
);

Parameter

wDeviceID: Pengidentifikasi perangkat perangkat MCI yang akan menerima pesan perintah.
dwFlags: MCI_NOTIFY, MCI_WAIT, atau MCI_TEST. Untuk informasi tentang bendera ini, lihat Bendera Tunggu, Beri Tahu, dan Uji.
lpSetVideo: Penunjuk ke struktur MCI_GENERIC_PARMS . (Perangkat dengan set perintah yang diperluas mungkin mengganti struktur ini dengan struktur khusus perangkat.)

Tampilkan Nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya.

Keterangan

Bendera tambahan berikut digunakan dengan jenis perangkat "digitalvideo":

MCI_DGV_SETVIDEO_ALG

Anggota lpstrAlgorithm dari struktur yang diidentifikasi oleh lpSetVideo berisi alamat buffer yang berisi nama algoritma kompresi video. Algoritma kompresi digunakan oleh perintah MCI_RESERVE atau MCI_RECORD berikutnya. Algoritma yang tersedia bergantung pada perangkat.

Jika algoritma yang ditentukan tidak kompatibel dengan format file saat ini, format file diubah ke format default untuk algoritma.

MCI_DGV_SETVIDEO_CLOCKTIME

Ketika digunakan dengan MCI_DGV_SETVIDEO_OVER, menunjukkan waktu ditentukan dalam milidetik dan merupakan waktu absolut. (Kali ini tidak dalam langkah dengan bermain ruang kerja.)

MCI_DGV_SETVIDEO_INPUT

Memodifikasi MCI_DGV_SETVIDEO_BRIGHTNESS, MCI_DGV_SETVIDEO_COLOR, MCI_DGV_SETVIDEO_CONTRAST, MCI_DGV_SETVIDEO_GAMMA, MCI_DGV_SETVIDEO_SHARPNESS, atau MCI_DGV_SETVIDEO_TINT sehingga memengaruhi sinyal input dan memodifikasi apa yang direkam. Jika memungkinkan, ini adalah default saat memantau input.

MCI_DGV_SETVIDEO_ITEM

Konstanta video ditentukan dalam anggota dwItem struktur yang diidentifikasi oleh lpSetVideo. Konstanta mengidentifikasi nilai yang sedang ditetapkan. Anda dapat menentukan konstanta berikut dengan bendera ini:

MCI_AVI_SETVIDEO_DRAW_PROCEDURE

Alamat prosedur gambar baru ditentukan dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetVideo. Anda dapat menentukan prosedur gambar baru hanya ketika perangkat menganggur. Bendera ini hanya dikenali oleh driver video digital MCIAVI. Tidak ada bendera yang setara dengan bendera ini di antarmuka perintah string.

MCI_AVI_SETVIDEO_PALETTE_COLOR

Warna palet baru ditentukan dalam anggota dwOver dan dwValue struktur yang diidentifikasi oleh lpSetVideo. Anggota dwOver menentukan indeks palet warna yang akan diubah dan anggota dwValue menentukan warna baru, sebagai nilai RGB. Anda juga harus menentukan bendera MCI_DGV_SETVIDEO_OVER dan MCI_DGV_SETVIDEO_VALUE dengan MCI_DGV_SETVIDEO_ITEM saat Anda menggunakan konstanta ini. Bendera ini hanya dikenali oleh driver video digital MCIAVI.

MCI_AVI_SETVIDEO_PALETTE_HALFTONE

Menunjukkan bahwa palet halftone harus digunakan, bukan palet default. Bendera ini hanya dikenali oleh driver video digital MCIAVI.

MCI_DGV_SETVIDEO_BITSPERPEL

Jumlah bit per piksel ditentukan dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetVideo. Jumlah bit per piksel digunakan untuk menyimpan data yang diambil atau direkam

MCI_DGV_SETVIDEO_BRIGHTNESS

Tingkat kecerahan video ditentukan sebagai faktor dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetVideo.

MCI_DGV_SETVIDEO_COLOR

Tingkat saturasi warna video ditentukan sebagai faktor dalam anggota dwValue struktur yang diidentifikasi oleh lpSetVideo.

MCI_DGV_SETVIDEO_CONTRAST

Tingkat kontras video ditentukan sebagai faktor dalam anggota dwValue struktur yang diidentifikasi oleh lpSetVideo.

MCI_DGV_SETVIDEO_FRAME_RATE

Kecepatan bingkai ditentukan dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetVideo. Laju ditentukan dalam satuan bingkai per detik kali 1000. Misalnya, 29,97 bingkai per detik ditentukan sebagai 29970.

MCI_DGV_SETVIDEO_GAMMA

Nilai eksponen koreksi gamma ditentukan dalam anggota dwValue struktur yang diidentifikasi oleh lpSetVideo. Koreksi Gamma menyesuaikan pemetaan antara intensitas yang dikodekan dalam sumber presentasi dan kecerahan yang ditampilkan. Nilainya adalah eksponen dikalikan dengan 1000. Misalnya, 2200 menunjukkan eksponen 2,2. Nilai 1000 menunjukkan eksponen 1, yang tidak menerapkan koreksi gamma.

MCI_DGV_SETVIDEO_KEY_COLOR

Warna kunci ditentukan dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetVideo. Warna kunci adalah nilai RGB.

MCI_DGV_SETVIDEO_KEY_INDEX

Nilai indeks kunci ditentukan dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetVideo. Parameter indeks adalah indeks palet fisik.

MCI_DGV_SETVIDEO_PALHANDLE

Handel palet ditentukan dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetVideo. Gagang palet terkandung dalam kata berurutan rendah. Perangkat digital-video tidak boleh membebaskan palet yang diteruskan dengan perintah ini. Aplikasi harus membebaskannya setelah menutup perangkat. Bendera ini hanya didukung oleh perangkat yang menggunakan palet. Jika gagang palet yang ditentukan ini adalah nol, maka palet default digunakan.

MCI_DGV_SETVIDEO_SHARPNESS

Nilai ketajaman video ditentukan sebagai faktor dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetVideo.

MCI_DGV_SETVIDEO_SOURCE

Konstanta yang menentukan sumber input video ditentukan dalam anggota dwValue struktur yang diidentifikasi oleh lpSetVideo. Konstanta berikut didefinisikan:

MCI_DGV_SETVIDEO_SRC_NTSC: Televisi NTSC.
MCI_DGV_SETVIDEO_SRC_PAL: TELEVISI PAL.
MCI_DGV_SETVIDEO_SRC_RGB: Video RGB.
MCI_DGV_SETVIDEO_SRC_SECAM: TELEVISI SECAM.
MCI_DGV_SETVIDEO_SRC_SVIDEO: S-Video.

MCI_DGV_SETVIDEO_STREAM

Aliran video ditentukan dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetVideo. Nilai bilangan bulat menentukan aliran video yang diputar kembali dari ruang kerja. Jika aliran tidak ditentukan dan format file tidak menentukan aliran default, aliran video pertama yang diselingi secara fisik diputar.

MCI_DGV_SETVIDEO_TINT

Nilai warna video ditentukan sebagai faktor dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetVideo. Biasanya, penyesuaian ini dimodelkan setelah kontrol rona dari banyak set televisi warna, dengan 250 didefinisikan sebagai hijau, 750 didefinisikan sebagai merah, dan 0 (atau 1000) didefinisikan sebagai biru. Nilai nominal selalu 500.

MCI_DGV_SETVIDEO_OUTPUT

Bendera MCI_DGV_SETVIDEO_BRIGHTNESS, MCI_DGV_SETVIDEO_COLOR, MCI_DGV_SETVIDEO_CONTRAST, MCI_DGV_SETVIDEO_GAMMA, MCI_DGV_SETVIDEO_SHARPNESS, atau MCI_DGV_SETVIDEO_TINT dimodifikasi sehingga hanya memengaruhi sinyal yang ditampilkan dan bukan apa yang direkam. Jika memungkinkan, ini adalah default saat memantau file.

MCI_DGV_SETVIDEO_OVER

Parameter panjang transisi disertakan dalam anggota dwOver struktur yang diidentifikasi oleh lpSetVideo. Panjang transisi menentukan berapa lama (dalam format waktu saat ini) yang diperlukan untuk membuat perubahan. Jika bendera ini tidak digunakan, perubahan akan segera terjadi.

MCI_DGV_SETVIDEO_QUALITY

Anggota lpstrQuality dari struktur yang diidentifikasi oleh lpSetVideo berisi alamat buffer yang menjelaskan kualitas video. String teks dalam buffer menentukan karakteristik algoritma kompresi video.

Bendera MCI_DGV_SETVIDEO_ALG dapat digunakan untuk memilih deskriptor kualitas untuk algoritma yang ditentukan. Jika bendera ini dihilangkan, maka algoritma saat ini digunakan.

Algoritma dan nama deskriptor yang tersedia bergantung pada perangkat. Setiap perangkat menyediakan dokumentasi untuk algoritma yang tersedia dan deskripsi nama deskriptor yang berlaku. Perintah MCI_QUALITY dapat menentukan nama deskriptor tambahan. Semua perangkat mendukung deskriptor "rendah", "sedang", dan "tinggi". Defaultnya adalah driver spesifik.

MCI_DGV_SETVIDEO_RECORD

Menentukan apakah perekaman menyertakan atau mengecualikan data video. Saat dikombinasikan dengan MCI_SET_ON, data video direkam. Saat dikombinasikan dengan MCI_SET_OFF, data video dikecualikan. Defaultnya mencakup data video.

MCI_DGV_SETVIDEO_SRC_NUMBER

Angka untuk sumber video ditentukan dalam anggota dwSourceNumber dari struktur yang diidentifikasi oleh lpSetVideo. Jika ada lebih dari satu input jenis yang ditentukan oleh MCI_DGV_SETVIDEO_VALUE, nilai akan memilih input. Bendera ini harus selalu digunakan dengan MCI_DGV_SETVIDEO_SOURCE. Namun, jika MCI_DGV_SETVIDEO_VALUE dihilangkan, nomor sumber yang ditentukan menunjukkan sumber absolut untuk digunakan seperti yang ditentukan dalam perintah MCI_LIST .

MCI_DGV_SETVIDEO_STILL

Nama algoritma atau nilai kualitas yang ditentukan berlaku untuk gambar diam.

Setiap driver perangkat harus mendukung algoritma "tidak ada", yang berarti tidak ada pemadatan. Ini adalah default. Dalam hal ini, perangkat video digital menyimpan gambar diam sebagai bitmap (DIB) independen perangkat RGB.

MCI_DGV_SETVIDEO_VALUE

Nilai disertakan dalam anggota dwValue dari struktur yang diidentifikasi oleh lpSetVideo. Arti nilai ditentukan oleh bendera MCI_DGV_SETVIDEO_ITEM .

MCI_SET_OFF

Menonaktifkan output video. Untuk perangkat video digital, menonaktifkan video mengatur piksel dalam persegi panjang tujuan yang ditentukan oleh perintah MCI_PUT (atau defaultnya, wilayah klien jendela saat ini) ke warna solid, tetapi tidak berpengaruh pada buffer bingkai. Anda dapat menyembunyikan jendela dengan perintah MCI_WINDOW jika diinginkan. Sumber video, apakah itu ruang kerja atau input eksternal, mungkin terus menyimpan gambar baru di buffer bingkai, tetapi tidak ditampilkan sampai video diaktifkan. Meskipun aplikasi harus menggunakan perintah MCI_SETVIDEO untuk mengontrol fungsi ini, perangkat digital-video harus tetap mendukung bendera ini. Nilai default setelah terbuka aktif.

MCI_SET_ON

Mengaktifkan output video.

Untuk perangkat video digital, parameter lpSetVideo menunjuk ke struktur MCI_DGV_SETVIDEO_PARMS .

Bendera tambahan berikut digunakan dengan jenis perangkat "vcr":

MCI_VCR_SETVIDEO_RECORD

Mengatur perekaman video ke aktif atau nonaktif. Digunakan bersama dengan salah satu bendera berikut:

MCI_SET_ON. Perekaman video aktif.
MCI_SET_OFF. Perekaman video nonaktif. Mungkin perlu untuk terlebih dahulu menonaktifkan perekaman yang merakit (menggunakan perintah MCI_SET dengan bendera MCI_VCR_SET_ASSEMBLE_RECORD diatur ke nonaktif) sebelum perekaman video dapat dinonaktifkan.

MCI_TRACK

Anggota dwTrack dari struktur yang diidentifikasi oleh lpSetVideo menentukan trek mana yang dipengaruhi oleh perintah.

MCI_VCR_SETVIDEO_SOURCE

Mengatur sumber video, dan harus digunakan dengan bendera MCI_VCR_SETVIDEO_TO .

MCI_VCR_SETVIDEO_MONITOR

Mengatur monitor sumber video, dan harus digunakan dengan bendera MCI_VCR_SETVIDEO_TO.

MCI_VCR_SETVIDEO_TO

Anggota dwTo dari struktur yang diidentifikasi oleh lpSetVideo berisi salah satu konstanta berikut:

**MCI\_VCR\_SRC\_TYPE\_TUNER**

**MCI\_VCR\_SRC\_TYPE\_LINE**

**MCI\_VCR\_SRC\_TYPE\_AUX**

**MCI\_VCR\_SRC\_TYPE\_GENERIC**

**MCI\_VCR\_SRC\_TYPE\_MUTE**

**MCI\_VCR\_SRC\_TYPE\_OUTPUT**

**MCI\_VCR\_SRC\_TYPE\_RGB**

**MCI\_VCR\_SETVIDEO\_NUMBER**

Anggota dwNumber dari struktur yang diidentifikasi oleh lpSetVideo berisi input video (dari jenis yang ditentukan dalam anggota dwTo ) untuk digunakan.

Untuk perangkat VCR, parameter lpSetVideo menunjuk ke struktur MCI_VCR_SETVIDEO_PARMS .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Mmsystem.h (termasuk Windows.h)

Lihat juga

MCI
Perintah MCI

Bagikan melalui