perintah MCI_SYSINFO

  • Artikel

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
Mmsystem.h (termasuk Windows.h)

Lihat juga

MCI

Perintah MCI