perintah putar

Perintah putar mulai memutar perangkat. Audio CD, digital-video, pengurut MIDI, videodisc, VCR, dan perangkat waveform-audio mengenali perintah ini.

Untuk mengirim perintah ini, panggil fungsi mciSendString dengan parameter lpszCommand yang ditetapkan sebagai berikut.

_stprintf_s(
  lpszCommand, 
  TEXT("play %s %s %s"), 
  lpszDeviceID, 
  lpszPlayFlags, 
  lpszFlags
); 

Parameter

lpszDeviceID

Pengidentifikasi perangkat MCI. Pengidentifikasi atau alias ini ditetapkan saat perangkat dibuka.

lpszPlayFlags

Bendera untuk memutar perangkat. Tabel berikut mencantumkan jenis perangkat yang mengenali perintah putar dan bendera yang digunakan oleh setiap jenis.

Nilai Makna Makna
cdaudio dari posisi ke posisi
digitalvideo dari pengulangan positionfullscreen balik ke positionwindow
Sequencer dari posisi ke posisi
Vcr pada timefrompositionreverse pindai ke posisi
videodisc cepat dari pemindaian posisi terbalik posisibilangan bulat kecepatan lambat
waveaudio dari posisi ke posisi

Tabel berikut mencantumkan bendera yang dapat ditentukan dalam parameter lpszPlayFlags dan maknanya.

Nilai Makna
pada waktunya Menunjukkan kapan perangkat harus mulai melakukan perintah ini, atau, jika perangkat telah dihukum, ketika perintah terisi dimulai. Untuk informasi selengkapnya, lihat perintah isian .
cepat Menunjukkan bahwa perangkat harus bermain lebih cepat dari biasanya. Untuk menentukan kecepatan yang tepat pada pemutar videodisc, gunakan bendera "kecepatan" dari perintah status . Untuk menentukan kecepatan dengan lebih tepat, gunakan bendera "kecepatan" dari perintah ini.
dari posisi Menentukan posisi awal untuk pemutaran. Jika bendera "dari" tidak ditentukan, pemutaran dimulai pada posisi saat ini. Untuk perangkat cdaudio , jika posisi "dari" lebih besar dari posisi akhir disk, atau jika posisi "dari" lebih besar dari posisi "ke", driver mengembalikan kesalahan. Untuk perangkat videodisc , posisi default berada dalam bingkai untuk cakram CAV dan dalam jam, menit, dan detik untuk disk CLV.
Fullscreen Menentukan bahwa tampilan layar penuh harus digunakan. Gunakan bendera ini hanya ketika memutar file terkompresi. (File yang tidak dikompresi tidak akan diputar layar penuh.)
repeat Menentukan bahwa pemutaran harus dimulai ulang ketika akhir konten tercapai.
reverse Menentukan bahwa arah putar mundur. Anda tidak dapat menentukan lokasi akhir dengan bendera "terbalik". Untuk videodiscs, "scan" hanya berlaku untuk format CAV.
Scan Diputar secepat mungkin tanpa menonaktifkan video (meskipun audio mungkin dinonaktifkan). Untuk videodiscs, "scan" hanya berlaku untuk format CAV.
lambat Bermain perlahan- lahan. Untuk menentukan kecepatan yang tepat pada pemutar videodisc, gunakan bendera "kecepatan" dari perintah status . Untuk menentukan kecepatan dengan lebih tepat, gunakan bendera "kecepatan" dari perintah ini. Untuk videodisc, "lambat" hanya berlaku untuk format CAV.
bilangan bulat kecepatan Memutar videodisc pada kecepatan yang ditentukan, dalam bingkai per detik. Bendera ini hanya berlaku untuk cakram CAV.
ke posisi Menentukan posisi akhir untuk pemutaran. Jika bendera "ke" tidak ditentukan, pemutaran akan berhenti di akhir konten. Untuk perangkat cdaudio , jika posisi "ke" lebih besar dari posisi akhir disk, driver mengembalikan kesalahan. Untuk perangkat videodisc , posisi default berada dalam bingkai untuk cakram CAV dan dalam jam, menit, dan detik untuk disk CLV.
jendela Menentukan bahwa pemutaran harus menggunakan jendela yang terkait dengan instans perangkat. Ini adalah pengaturan default.

lpszFlags

Bisa "tunggu", "beri tahu", atau keduanya. Untuk perangkat digital-video dan VCR, "pengujian" juga dapat ditentukan. Untuk informasi selengkapnya tentang bendera ini, lihat Bendera Tunggu, Beri Tahu, dan Uji.

Tampilkan Nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya.

Keterangan

Sebelum mengeluarkan perintah yang menggunakan nilai posisi, Anda harus mengatur format waktu yang diinginkan dengan menggunakan perintah set . Perintah ini mulai diputar pada kecepatan saat ini, sebagaimana diatur dengan perintah "kecepatan" yang ditetapkan. Arah dibalik jika bendera "terbalik" ditentukan, atau jika bendera "ke" ditentukan sebagai nilai yang kurang dari bendera "dari". Jika bendera "dari" tidak ditentukan, pemutaran dimulai pada posisi saat ini. Bendera "ke" dan "terbalik" tidak dapat digunakan bersama-sama.

Contoh

Perintah berikut memutar perangkat "mysound" dari posisi 1000 hingga posisi 2000, mengirim pesan pemberitahuan saat pemutaran selesai.

play mysound from 1000 to 2000 notify

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
Windows 2000 Professional [khusus aplikasi desktop]
Server minimum yang didukung
Windows 2000 Server [hanya aplikasi desktop]

Lihat juga

MCI

String Perintah MCI

isyarat

Set