perintah MCI_GETDEVCAPS

Artikel
06/13/2023

Perintah MCI_GETDEVCAPS mengambil informasi statis tentang perangkat. Semua perangkat mengenali perintah ini. Parameter dan bendera yang tersedia untuk perintah ini bergantung pada perangkat yang dipilih. Informasi dikembalikan dalam anggota dwReturn dari struktur yang diidentifikasi oleh lpCapsParms.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_GETDEVCAPS, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GETDEVCAPS_PARMS) lpCapsParms
);

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.
lpCapsParms: Arahkan ke struktur MCI_GETDEVCAPS_PARMS .

Tampilkan Nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya.

Keterangan

Bendera standar dan khusus perintah tambahan berikut berlaku untuk semua perangkat yang mendukung MCI_GETDEVCAPS:

MCI_GETDEVCAPS_COMPOUND_DEVICE: Anggota dwReturn diatur ke TRUE jika perangkat menggunakan penyimpanan data yang harus dibuka dan ditutup secara eksplisit; diatur ke FALSE jika tidak.
MCI_GETDEVCAPS_DEVICE_TYPE: Anggota dwReturn diatur ke salah satu nilai yang tercantum dalam Jenis Perangkat MCI.
MCI_GETDEVCAPS_HAS_AUDIO: Anggota dwReturn diatur ke TRUE jika perangkat memiliki output audio; diatur ke FALSE jika tidak.
MCI_GETDEVCAPS_HAS_VIDEO: Anggota dwReturn diatur ke TRUE jika perangkat memiliki output video; diatur ke FALSE jika tidak. Misalnya, anggota diatur ke TRUE untuk perangkat yang mendukung set perintah videodisc.
MCI_GETDEVCAPS_ITEM: Menentukan bahwa anggota dwItem dari struktur MCI_GETDEVCAPS_PARMS berisi salah satu konstanta berikut:
MCI_GETDEVCAPS_CAN_EJECT: Anggota dwReturn diatur ke TRUE jika perangkat dapat mengeluarkan media; jika tidak, ini diatur ke FALSE.
MCI_GETDEVCAPS_CAN_PLAY: Anggota dwReturn diatur ke TRUE jika perangkat dapat memutar media; jika tidak, ini diatur ke FALSE. Jika perangkat menentukan TRUE, perangkat menyiratkan perangkat mendukung perintah MCI_PAUSE dan MCI_STOP serta perintah MCI_PLAY .
MCI_GETDEVCAPS_CAN_RECORD: Anggota dwReturn diatur ke TRUE jika perangkat mendukung perekaman; jika tidak, ini diatur ke FALSE. Jika perangkat menentukan TRUE, perangkat menyiratkan perangkat mendukung perintah MCI_PAUSE dan MCI_STOP serta perintah MCI_RECORD .
MCI_GETDEVCAPS_CAN_SAVE: Anggota dwReturn diatur ke TRUE jika perangkat dapat menyimpan file; jika tidak, ini diatur ke FALSE.
MCI_GETDEVCAPS_USES_FILES: Anggota dwReturn diatur ke TRUE jika perangkat memerlukan nama file; diatur ke FALSE jika tidak. Hanya perangkat campuran yang menggunakan file.

Bendera berikut dapat ditentukan dalam anggota dwItemMCI_GETDEVCAPS_PARMS untuk jenis perangkat digitalvideo :

MCI_DGV_GETDEVCAPS_CAN_FREEZE: Anggota dwReturn diatur ke TRUE jika perangkat dapat membekukan bingkai; jika tidak, ini diatur ke FALSE.
MCI_DGV_GETDEVCAPS_CAN_LOCK: Anggota dwReturn diatur ke TRUE jika perangkat dapat mengunci; jika tidak, ini diatur ke FALSE.
MCI_DGV_GETDEVCAPS_CAN_REVERSE: Anggota dwReturn diatur ke TRUE jika perangkat dapat bermain secara terbalik; jika tidak, ini diatur ke FALSE.
MCI_DGV_GETDEVCAPS_CAN_STR_IN: Anggota dwReturn diatur ke TRUE jika perangkat dapat meregangkan input; jika tidak, ini diatur ke FALSE.
MCI_DGV_GETDEVCAPS_CAN_STRETCH: Anggota dwReturn diatur ke TRUE jika perangkat dapat meregangkan gambar; jika tidak, ini diatur ke FALSE.
MCI_DGV_GETDEVCAPS_CAN_TEST: Anggota dwReturn diatur ke TRUE jika perangkat dapat melakukan pengujian; jika tidak, ini diatur ke FALSE.
MCI_DGV_GETDEVCAPS_HAS_STILL: Anggota dwReturn diatur ke TRUE jika perangkat dapat menampilkan gambar diam; jika tidak, ini diatur ke FALSE.
MCI_DGV_GETDEVCAPS_MAX_WINDOWS: Anggota dwReturn diatur ke jumlah maksimum jendela yang dapat ditangani perangkat secara bersamaan.
MCI_DGV_GETDEVCAPS_MAXIMUM_RATE: Anggota dwReturn diatur ke laju putar maksimum untuk perangkat, dalam bingkai per detik.
MCI_DGV_GETDEVCAPS_MINIMUM_RATE: Anggota dwReturn diatur ke laju putar minimum untuk perangkat, dalam bingkai per detik.
MCI_DGV_GETDEVCAPS_PALETTES: Anggota dwReturn diatur ke TRUE jika perangkat dapat mengembalikan gagang palet; jika tidak, ini diatur ke FALSE.

Bendera berikut dapat ditentukan di anggota dwItemdari MCI_GETDEVCAPS_PARMS untuk jenis perangkat vcr :

MCI_GETDEVCAPS_CLOCK_INCREMENT_RATE: Anggota dwReturn diatur ke jumlah kenaikan per detik.
MCI_VCR_GETDEVCAPS_CAN_DETECT_LENGTH: Anggota dwReturn diatur ke TRUE jika perangkat mampu mendeteksi panjang media; jika tidak, ini diatur ke FALSE.
MCI_VCR_GETDEVCAPS_CAN_FREEZE: Anggota dwReturn diatur ke TRUE jika perangkat mampu membekukan gambar output; jika tidak, ini diatur ke FALSE.
MCI_VCR_GETDEVCAPS_CAN_MONITOR_SOURCES: Anggota dwReturn diatur ke TRUE jika perangkat mampu memantau sumber; jika tidak, ini diatur ke FALSE.
MCI_VCR_GETDEVCAPS_CAN_PREROLL: Anggota dwReturn diatur ke TRUE jika perangkat mampu melakukan pra-pendaftaran; jika tidak, ini diatur ke FALSE.
MCI_VCR_GETDEVCAPS_CAN_PREVIEW: Anggota dwReturn diatur ke TRUE jika perangkat mampu melakukan pratinjau; jika tidak, ini diatur ke FALSE.
MCI_VCR_GETDEVCAPS_CAN_REVERSE: Anggota dwReturn diatur ke TRUE jika perangkat mampu diputar secara terbalik; jika tidak, ini diatur ke FALSE.
MCI_VCR_GETDEVCAPS_CAN_TEST: Anggota dwReturn diatur ke TRUE jika perangkat mampu menguji; jika tidak, ini diatur ke FALSE.
MCI_VCR_GETDEVCAPS_HAS_CLOCK: Anggota dwReturn diatur ke TRUE jika perangkat mendukung jam eksternal; jika tidak, ini diatur ke FALSE.
MCI_VCR_GETDEVCAPS_HAS_TIMECODE: Anggota dwReturn diatur ke TRUE jika perangkat memiliki kemampuan kode waktu atau jika kemampuan ini tidak diketahui; jika tidak, ini diatur ke FALSE.
MCI_VCR_GETDEVCAPS_NUMBER_OF_MARKS: Anggota dwReturn diatur ke jumlah tanda (99).
MCI_VCR_GETDEVCAPS_SEEK_ACCURACY: Anggota dwReturn diatur ke akurasi pencarian perangkat.

Bendera berikut dapat ditentukan di anggota dwItemMCI_GETDEVCAPS_PARMS untuk jenis perangkat overlay :

MCI_OVLY_GETDEVCAPS_CAN_FREEZE: Anggota dwReturn diatur ke TRUE jika perangkat dapat membekukan gambar; jika tidak, ini diatur ke FALSE.
MCI_OVLY_GETDEVCAPS_CAN_STRETCH: Anggota dwReturn diatur ke TRUE jika perangkat dapat meregangkan gambar untuk mengisi bingkai; jika tidak, ini diatur ke FALSE.
MCI_OVLY_GETDEVCAPS_MAX_WINDOWS: Anggota dwReturn diatur ke jumlah maksimum jendela yang dapat ditangani perangkat secara bersamaan.

Bendera berikut dapat ditentukan di anggota dwItemMCI_GETDEVCAPS_PARMS untuk jenis perangkat videodisc :

MCI_VD_GETDEVCAPS_CAN_REVERSE: Anggota dwReturn diatur ke TRUE jika pemutar videodisc dapat diputar secara terbalik; jika tidak, ini diatur ke FALSE. Beberapa pemain dapat memainkan disk CLV secara terbalik serta cakram CAV.
MCI_VD_GETDEVCAPS_CAV: Saat dikombinasikan dengan item lain, menentukan bahwa informasi pengembalian berlaku untuk videodisc format CAV. Ini adalah default jika tidak ada videodisc yang disisipkan.
MCI_VD_GETDEVCAPS_CLV: Saat dikombinasikan dengan item lain, menentukan bahwa informasi pengembalian berlaku untuk videodisc format CLV.
MCI_VD_GETDEVCAPS_FAST_RATE: Anggota dwReturn diatur ke laju bermain cepat standar dalam bingkai per detik.
MCI_VD_GETDEVCAPS_NORMAL_RATE: Anggota dwReturn diatur ke laju bermain normal dalam bingkai per detik.
MCI_VD_GETDEVCAPS_SLOW_RATE: Anggota dwReturn diatur ke laju putar lambat standar dalam bingkai per detik.

Bendera berikut dapat ditentukan di anggota dwItemdari MCI_GETDEVCAPS_PARMS untuk jenis perangkat waveaudio :

MCI_WAVE_GETDEVCAPS_INPUT: Anggota dwReturn diatur ke jumlah total perangkat input bentuk gelombang (perekaman).
MCI_WAVE_GETDEVCAPS_OUTPUT: Anggota dwReturn diatur ke jumlah total perangkat output bentuk gelombang (pemutaran).

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

Bagikan melalui