perintah MCI_PUT
Perintah MCI_PUT mengatur persegi sumber, tujuan, dan bingkai. Perangkat digital-video dan video-overlay mengenali perintah ini.
Untuk mengirim perintah ini, panggil fungsi mciSendCommand dengan parameter berikut.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_PUT,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpDest
);
Parameter
-
wDeviceID
-
Pengidentifikasi perangkat perangkat MCI yang akan menerima pesan perintah.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT, atau, untuk perangkat video digital, MCI_TEST. Untuk informasi tentang bendera ini, lihat Bendera Tunggu, Beri Tahu, dan Uji.
-
lpDest
-
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_PUT_CLIENT
-
Persegi panjang yang ditentukan untuk MCI_DGV_RECT berlaku untuk posisi jendela klien. Persegi panjang yang ditentukan relatif terhadap jendela induk jendela tampilan. MCI_DGV_PUT_WINDOW harus diatur bersamaan dengan bendera ini.
-
MCI_DGV_PUT_DESTINATION
-
Persegi panjang yang ditentukan untuk MCI_DGV_RECT menentukan persegi panjang tujuan. Persegi panjang tujuan menentukan bagian jendela klien yang terkait dengan instans driver perangkat ini yang menunjukkan gambar atau video.
-
MCI_DGV_PUT_FRAME
-
Persegi panjang yang ditentukan untuk MCI_DGV_RECT berlaku untuk persegi panjang bingkai. Persegi panjang bingkai menentukan bagian buffer bingkai yang digunakan sebagai tujuan gambar video yang diperoleh dari persegi panjang video. Video harus diskalakan agar pas dalam persegi panjang buffer bingkai.
Persegi ditentukan dalam koordinat buffer bingkai. Persegi panjang default adalah buffer bingkai penuh. Menentukan persegi panjang ini memungkinkan perangkat menskalakan gambar saat mendigitalkan data. Perangkat yang tidak dapat menskalakan gambar menolak perintah ini dengan MCIERR_UNSUPPORTED_FUNCTION. Anda dapat menggunakan bendera MCI_GETDEVCAPS_CAN_STRETCH dengan perintah MCI_GETDEVCAPS untuk menentukan apakah perangkat menskalakan gambar. Perangkat mengembalikan FALSE jika tidak dapat menskalakan gambar.
-
MCI_DGV_PUT_SOURCE
-
Persegi panjang yang ditentukan untuk MCI_DGV_RECT menentukan persegi panjang sumber. Persegi panjang sumber menentukan bagian buffer bingkai mana yang akan diskalakan agar pas dengan persegi panjang tujuan.
-
MCI_DGV_PUT_VIDEO
-
Persegi panjang yang ditentukan untuk MCI_DGV_RECT berlaku untuk persegi panjang video. Persegi panjang video menentukan bagian mana dari sumber presentasi saat ini yang disimpan dalam buffer bingkai. Persegi ditentukan menggunakan koordinat alami sumber presentasi. Ini memungkinkan spesifikasi pemangkasan yang terjadi sebelum menyimpan gambar dan video di buffer bingkai. Persegi panjang default adalah area pemindaian aktif penuh atau gambar dan video penuh yang didekompresi.
-
MCI_DGV_PUT_WINDOW
-
Persegi panjang yang ditentukan untuk MCI_DGV_RECT berlaku untuk jendela tampilan. Persegi panjang ini relatif terhadap jendela induk jendela tampilan (biasanya desktop). Jika jendela tidak ditentukan, jendela default ke ukuran dan posisi jendela awal.
-
MCI_DGV_RECT
-
Anggota rc struktur yang diidentifikasi oleh lpDest berisi persegi panjang yang valid.
Untuk perangkat video digital, lpDest menunjuk ke struktur MCI_DGV_PUT_PARMS .
Bendera tambahan berikut digunakan dengan jenis perangkat overlay :
-
MCI_OVLY_PUT_DESTINATION
-
Persegi panjang yang ditentukan untuk MCI_OVLY_RECT menentukan area jendela klien yang digunakan untuk menampilkan gambar. Persegi panjang berisi offset dan jangkauan gambar yang terlihat relatif terhadap asal jendela. Jika bingkai sedang direntangkan, sumber direntangkan ke persegi panjang tujuan.
-
MCI_OVLY_PUT_FRAME
-
Persegi panjang yang ditentukan untuk MCI_OVLY_RECT menentukan area buffer video yang digunakan untuk menerima gambar video. Persegi panjang berisi offset dan luas area buffer relatif terhadap asal buffer video.
-
MCI_OVLY_PUT_SOURCE
-
Persegi panjang yang ditentukan untuk MCI_OVLY_RECT menentukan area buffer video yang digunakan sebagai sumber gambar digital. Persegi panjang berisi offset dan luas persegi panjang kliping untuk buffer video relatif terhadap asalnya.
-
MCI_OVLY_PUT_VIDEO
-
Persegi panjang yang ditentukan untuk MCI_OVLY_RECT menentukan area pengambilan sumber video oleh buffer video. Persegi panjang berisi offset dan jangkauan persegi panjang kliping untuk sumber video relatif terhadap asalnya.
-
MCI_OVLY_RECT
-
Anggota rc struktur yang diidentifikasi oleh lpDest berisi persegi panjang tampilan yang valid. Jika bendera ini tidak ditentukan, persegi panjang default cocok dengan koordinat buffer video atau jendela yang sedang diklip.
Untuk perangkat video-overlay, lpDest menunjuk ke struktur MCI_OVLY_RECT_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 |
|