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 posisifullscreen repeat	balik ke jendela posisi
Sequencer	dari posisi	ke posisi
Vcr	pada waktudari posisiterbalik	pindai ke posisi
videodisc	cepat dari pemindaian terbalik posisi	bilangan bulatkecepatan lambat ke posisi
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 [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]

Lihat juga

MCI

String Perintah MCI

Isyarat

set