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	Mmsystem.h (termasuk Windows.h)

Lihat juga

MCI

Perintah MCI