perintah MCI_SETVIDEO
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 |
|
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk