perintah MCI_SEEK

Perintah MCI_SEEK mengubah posisi saat ini dalam konten secepat mungkin. Output video dan audio dinonaktifkan selama pencarian. Setelah pencarian selesai, perangkat dihentikan. Audio CD, digital-video, pengurut MIDI, VCR, videodisc, dan perangkat waveform-audio mengenali perintah ini.

Untuk mengirim perintah ini, panggil fungsi mciSendCommand dengan parameter berikut.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SEEK, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SEEK_PARMS) lpSeek
);

Parameter

wDeviceID

Pengidentifikasi perangkat perangkat MCI yang akan menerima pesan perintah.

dwFlags

MCI_NOTIFY, MCI_WAIT, atau, untuk perangkat digital-video dan VCR, MCI_TEST. Untuk informasi tentang bendera ini, lihat Bendera Tunggu, Beri Tahu, dan Uji.

lpSeek

Arahkan ke struktur MCI_SEEK_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

Jika ukuran sampel data untuk perangkat lebih besar dari 1 byte (seperti dengan data stereo waveform-audio), perintah ini berpindah ke awal sampel terdekat ketika posisi yang ditentukan tidak bertepatan dengan awal sampel.

Bendera tambahan berikut berlaku untuk semua perangkat yang mendukung MCI_SEEK:

MCI_SEEK_TO_END

Cari di akhir konten.

MCI_SEEK_TO_START

Cari ke awal konten.

MCI_TO

Posisi termasuk dalam anggota dwTo dari struktur yang diidentifikasi oleh lpSeek. Unit yang ditetapkan ke nilai posisi ditentukan dengan bendera MCI_SET_TIME_FORMAT perintah MCI_SET . Jangan gunakan bendera ini dengan MCI_SEEK_TO_END atau MCI_SEEK_TO_START.

Bendera tambahan berikut digunakan dengan jenis perangkat vcr :

MCI_VCR_SEEK_AT

Anggota dwAt struktur yang diidentifikasi oleh lpSeek berisi waktu ketika seluruh perintah dimulai.

MCI_VCR_SEEK_MARK

Anggota dwMark dari struktur yang diidentifikasi oleh lpSeek berisi tanda bernomor untuk dicari.

MCI_VCR_SEEK_REVERSE

Arah pencarian terbalik; ini hanya digunakan dengan bendera MCI_VCR_SEEK_MARK.

Untuk perangkat VCR, parameter lpSeek menunjuk ke struktur MCI_VCR_SEEK_PARMS .

Bendera tambahan berikut digunakan dengan jenis perangkat videodisc :

MCI_VD_SEEK_REVERSE

Arah pencarian terbalik.

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