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 |
|