Bagikan melalui


perintah MCI_GETDEVCAPS

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