perintah seek

Perintah pencarian berpindah ke posisi dan berhenti yang ditentukan. Audio CD, digital-video, pengurut MIDI, VCR, videodisc, 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("seek %s %s %s"), 
  lpszDeviceID, 
  lpszSeekFlags, 
  lpszFlags
); 

Parameter

lpszDeviceID

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

lpszSeekFlags

Bendera untuk pindah ke posisi tertentu. Tabel berikut ini mencantumkan jenis perangkat yang mengenali perintah pencarian dan bendera yang digunakan oleh setiap jenis.

Nilai	Makna	Makna
cdaudio	ke ujung ke posisi	untuk memulai
digitalvideo	ke ujung ke posisi	untuk memulai
Sequencer	ke ujung ke posisi	untuk memulai
Vcr	pada tanda waktumark_numterbalik	ke ujung ke posisiuntuk memulai
videodisc	balik ke ujung	ke posisiuntuk memulai
waveaudio	ke ujung ke posisi	untuk memulai

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

Nilai	Makna
pada waktunya	Menunjukkan kapan perangkat harus mulai melakukan perintah ini, atau, jika perangkat telah ditandatangani, ketika perintah berpeluk dimulai. Untuk informasi selengkapnya, lihat perintah isian .
tandai mark_num	Mencari tanda relatif yang ditunjukkan oleh mark_num, yang harus merupakan nilai bilangan bulat positif. Tanda adalah sinyal yang ditulis ke pita VCR menggunakan perintah tandai dan digunakan untuk pencarian berkecepatan tinggi.
reverse	Menunjukkan bahwa arah pencarian pada VCR dan videodisc CAV mundur. Bendera ini tidak valid jika bendera "ke" ditentukan. Untuk VCR, bendera ini harus digunakan dengan bendera "tanda".
ke ujung	Mencari ke akhir konten.
ke posisi	Menentukan posisi untuk menghentikan pencarian. Untuk perangkat cdaudio , MCI mengembalikan kesalahan di luar rentang jika posisi yang ditentukan lebih besar dari panjang disk.
untuk memulai	Mencari ke awal konten.

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 apa pun yang menggunakan nilai posisi, Anda harus mengatur format waktu yang diinginkan dengan menggunakan perintah set .

Perangkat digital-video mendukung dua mode pencarian, yang dapat Anda ubah dengan menggunakan perintah set . Mode "cari tepat pada" menyebabkan perintah pencarian berpindah ke bingkai yang ditentukan. Mode "cari tepat" menyebabkan perintah pencarian berpindah ke bingkai kunci terdekat sebelum bingkai yang ditentukan.

Jika perangkat audio CD diputar saat perintah pencarian dikeluarkan, pemutaran dihentikan. Ketika perintah pencarian dikeluarkan dengan perangkat videodisc, perangkat mencari menggunakan maju cepat atau mundur cepat dengan video dan audio nonaktif.

Ketika perintah pencarian dikeluarkan dengan perangkat waveform-audio, perilaku tergantung pada ukuran sampel. Jika ukuran sampel adalah 16 bit atau lebih besar, cari perpindahan ke awal sampel terdekat ketika posisi yang ditentukan tidak bertepatan dengan awal sampel.

Contoh

Perintah berikut mencari awal file media yang terkait dengan perangkat "mysound".

seek mysound to start

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

Mark

set