fungsi acmDriverMessage (msacm.h)

Artikel
08/24/2023

Fungsi acmDriverMessage mengirimkan pesan yang ditentukan pengguna ke instans driver ACM tertentu.

Sintaks

LRESULT ACMAPI acmDriverMessage(
  HACMDRIVER had,
  UINT       uMsg,
  LPARAM     lParam1,
  LPARAM     lParam2
);

Parameter

had

Tangani ke instans driver ACM tempat pesan akan dikirim.

uMsg

Pesan bahwa driver ACM harus diproses. Pesan ini harus dalam rentang pesan ACMDM_USER (di atas atau sama dengan ACMDM_USER dan kurang dari ACMDM_RESERVED_LOW). Pengecualian untuk pembatasan ini adalah pesan ACMDM_DRIVER_ABOUT, DRV_QUERYCONFIGURE, dan DRV_CONFIGURE .

lParam1

Parameter pesan.

lParam2

Parameter pesan.

Menampilkan nilai

Nilai yang dikembalikan khusus untuk pesan driver ACM yang ditentukan pengguna yang ditentukan oleh parameter uMsg. Namun, kemungkinan nilai kesalahan termasuk yang berikut ini.

Menampilkan kode	Deskripsi
MMSYSERR_INVALHANDLE	Handel yang ditentukan tidak valid.
MMSYSERR_INVALPARAM	Parameter uMsg tidak dalam rentang ACMDM_USER.
MMSYSERR_NOTSUPPORTED	Driver ACM tidak memproses pesan.

Keterangan

Untuk menampilkan kotak dialog Tentang kustom dari driver ACM, aplikasi harus mengirim pesan ACMDM_DRIVER_ABOUT ke driver. Parameter lParam1 harus menjadi handel jendela pemilik untuk kotak dialog Tentang kustom, dan lParam2 harus diatur ke nol. Jika driver tidak mendukung kotak dialog Tentang kustom, MMSYSERR_NOTSUPPORTED akan dikembalikan dan merupakan tanggung jawab aplikasi untuk menampilkan kotak dialognya sendiri. Misalnya, opsi Panel Kontrol Sound Mapper akan menampilkan kotak dialog Tentang default berdasarkan struktur ACMDRIVERDETAILS saat driver ACM kembali MMSYSERR_NOTSUPPORTED. Aplikasi dapat mengkueri driver untuk dukungan kotak dialog Tentang Kustom tanpa kotak dialog ditampilkan dengan mengatur lParam1 ke –1L. Jika driver mendukung kotak dialog Tentang kustom, MMSYSERR_NOERROR akan dikembalikan. Jika tidak, nilai yang dikembalikan MMSYSERR_NOTSUPPORTED.

Pesan yang ditentukan pengguna harus dikirim hanya ke driver ACM yang secara khusus mendukung pesan. Pemanggil harus memverifikasi bahwa driver ACM adalah driver yang benar dengan mengambil detail driver dan memeriksa anggota wMid, wPid, dan vdwDriver dari struktur ACMDRIVERDETAILS .

Jangan pernah mengirim pesan yang ditentukan pengguna ke driver ACM yang tidak dikenal.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	msacm.h
Pustaka	Msacm32.lib
DLL	Msacm32.dll

Lihat juga

Fungsi Pemadatan Audio

Pengelola Kompresi Audio

Bagikan melalui