perintah MCI_SYSINFO
Perintah MCI_SYSINFO mengambil informasi tentang perangkat MCI. MCI mendukung perintah ini secara langsung daripada meneruskannya ke perangkat. Aplikasi MCI apa pun dapat menggunakan perintah ini. Informasi string dikembalikan dalam buffer yang disediakan aplikasi yang ditujukkan oleh anggota lpstrReturn dari struktur yang diidentifikasi oleh lpSysInfo. Informasi numerik dikembalikan sebagai nilai DWORD yang ditempatkan dalam buffer yang disediakan aplikasi. Anggota dwRetSize menentukan panjang buffer.
Untuk mengirim perintah ini, panggil fungsi mciSendCommand dengan parameter berikut.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_SYSINFO,
DWORD dwFlags,
(DWORD) (LPMCI_SYSINFO_PARMS) lpSysInfo
);
Parameter
-
wDeviceID
-
Pengidentifikasi perangkat perangkat MCI yang akan menerima pesan perintah.
-
dwFlags
-
Satu atau beberapa bendera standar dan khusus perintah berikut:
-
MCI_SYSINFO_INSTALLNAME
-
Mendapatkan nama (tercantum dalam registri atau file SYSTEM.INI) yang digunakan untuk menginstal perangkat.
-
MCI_SYSINFO_NAME
-
Mendapatkan nama perangkat yang sesuai dengan nomor perangkat yang ditentukan dalam anggota dwNumber struktur yang diidentifikasi olehlpSysInfo. Jika bendera MCI_SYSINFO_OPEN diatur, MCI mengembalikan nama perangkat terbuka.
-
MCI_SYSINFO_OPEN
-
Mendapatkan kuantitas atau nama perangkat terbuka.
-
MCI_SYSINFO_QUANTITY
-
Mendapatkan jumlah perangkat dari jenis yang ditentukan yang tercantum dalam registri atau bagian [mci] dari file SYSTEM.INI. Jika bendera MCI_SYSINFO_OPEN diatur, jumlah perangkat terbuka dikembalikan.
-
lpSysInfo
-
Arahkan ke struktur MCI_SYSINFO_PARMS .
Tampilkan Nilai
Mengembalikan nol jika berhasil atau kesalahan sebaliknya.
Keterangan
Anggota wDeviceType dari struktur yang diidentifikasi oleh lpSysInfo digunakan untuk menunjukkan jenis perangkat kueri. Jika parameter wDeviceID diatur ke MCI_ALL_DEVICE_ID, parameter tersebut akan menggantikan nilai wDeviceType. Untuk daftar jenis perangkat, lihat Jenis Perangkat MCI.
Nilai pengembalian bilangan bulat adalah nilai DWORD yang dikembalikan dalam buffer yang diarahkan oleh anggota lpstrReturn dari struktur yang diidentifikasi oleh lpSysInfo.
Nilai pengembalian string adalah string yang dihentikan null yang dikembalikan dalam buffer yang ditunjukkan oleh anggota lpstrReturn dari struktur yang diidentifikasi oleh lpSysInfo.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
| Header |
|