perintah MCI_INFO

Perintah MCI_INFO mengambil informasi string dari perangkat. Semua perangkat mengenali perintah ini. Informasi dikembalikan dalam anggota lpstrReturn dari struktur yang diidentifikasi oleh lpInfo. Anggota dwRetSize menentukan panjang buffer untuk data yang dikembalikan.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_INFO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_INFO_PARMS) lpInfo
);

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.

lpInfo

Arahkan ke struktur MCI_INFO_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 standar dan khusus perintah tambahan berikut berlaku untuk semua perangkat yang mendukung MCI_INFO:

MCI_INFO_PRODUCT

Mendapatkan deskripsi perangkat keras yang terkait dengan perangkat. Perangkat harus memberikan deskripsi yang mengidentifikasi driver dan perangkat keras yang digunakan.

Bendera tambahan berikut berlaku untuk jenis perangkat cdaudio :

MCI_INFO_MEDIA_IDENTITY

Menghasilkan pengidentifikasi unik untuk CD audio yang saat ini dimuat di pemutar yang sedang dikueri. Bendera ini mengembalikan string 16 digit heksadesimal.

MCI_INFO_MEDIA_UPC

Menghasilkan Universal Product Code (UPC) yang dikodekan pada CD audio. UPC adalah string digit. Mungkin tidak tersedia untuk semua CD.

Bendera tambahan berikut berlaku untuk jenis perangkat digitalvideo :

MCI_DGV_INFO_ITEM

Konstanta yang menunjukkan informasi yang diinginkan disertakan dalam anggota dwItem struktur yang diidentifikasi oleh lpInfo. Konstanta berikut didefinisikan untuk perangkat digital-video:

MCI_DGV_INFO_AUDIO_ALG

Mengembalikan nama untuk algoritma pemadatan audio saat ini.

MCI_DGV_INFO_AUDIO_QUALITY

Mengembalikan nama untuk deskriptor kualitas audio saat ini.

MCI_DGV_INFO_STILL_ALG

Mengembalikan nama untuk algoritma pemadatan gambar diam saat ini.

MCI_DGV_INFO_STILL_QUALITY

Mengembalikan nama untuk deskriptor kualitas gambar diam saat ini.

MCI_DGV_INFO_USAGE

Mengembalikan string yang menjelaskan pembatasan penggunaan yang mungkin diberlakukan oleh pemilik data visual atau yang dapat didengar di ruang kerja.

MCI_DGV_INFO_VIDEO_ALG

Mengembalikan nama untuk algoritma pemadatan video saat ini.

MCI_DGV_INFO_VIDEO_QUALITY

Mengembalikan nama untuk deskriptor kualitas video saat ini.

MCI_INFO_VERSION

Mengembalikan tingkat rilis driver perangkat dan perangkat keras. Pengembang driver perangkat harus men dokumentasikan sintaks string yang dikembalikan.

MCI_DGV_INFO_TEXT

Mendapatkan caption jendela.

MCI_INFO_FILE

Mendapatkan jalur dan nama file dari file terakhir yang ditentukan dengan perintah MCI_OPEN atau MCI_LOAD . Jika file belum ditentukan, perangkat mengembalikan string yang dihentikan null. Bendera ini hanya didukung oleh perangkat yang mengembalikan TRUE ke bendera MCI_GETDEVCAPS_USES_FILES perintah MCI_GETDEVCAPS .

Untuk perangkat video digital, lpInfo menunjuk ke struktur MCI_DGV_INFO_PARMS .

Bendera tambahan berikut berlaku untuk jenis perangkat sequencer :

MCI_INFO_COPYRIGHT

Mendapatkan pemberitahuan hak cipta file MIDI dari acara meta hak cipta.

MCI_INFO_FILE

Mendapatkan nama file dari file saat ini. Bendera ini hanya didukung oleh perangkat yang mengembalikan TRUE saat Anda memanggil perintah MCI_GETDEVCAPS dengan bendera MCI_GETDEVCAPS_USES_FILES.

MCI_INFO_NAME

Mendapatkan nama urutan dari peristiwa meta nama urutan/trek.

Bendera tambahan berikut berlaku untuk jenis perangkat vcr :

MCI_VCR_INFO_VERSION

Mengatur anggota lpstrReturn dari struktur MCI_INFO_PARMS untuk menunjuk ke nomor versi. Juga mengatur anggota dwRetSize sama dengan panjang string yang diarahkan.

Bendera tambahan berikut berlaku untuk jenis perangkat overlay :

MCI_INFO_FILE

Mendapatkan nama file dari file saat ini. Bendera ini hanya didukung oleh perangkat yang mengembalikan TRUE ke bendera MCI_GETDEVCAPS_USES_FILES perintah MCI_GETDEVCAPS .

MCI_OVLY_INFO_TEXT

Mendapatkan caption jendela yang terkait dengan perangkat video-overlay.

Bendera tambahan berikut berlaku untuk jenis perangkat waveaudio :

MCI_INFO_FILE

Mendapatkan nama file dari file saat ini. Bendera ini didukung oleh perangkat yang mengembalikan TRUE saat Anda memanggil perintah MCI_GETDEVCAPS dengan bendera MCI_GETDEVCAPS_USES_FILES.

MCI_WAVE_INPUT

Mendapatkan nama produk dari input saat ini.

MCI_WAVE_OUTPUT

Mendapatkan nama produk dari output saat ini dan nilainya spesifik untuk perangkat.

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