fungsi acmDriverAdd (msacm.h)

Artikel
08/24/2023

Fungsi acmDriverAdd menambahkan driver ke daftar driver ACM yang tersedia. Jenis driver dan lokasi tergantung pada bendera yang digunakan untuk menambahkan driver ACM. Setelah driver berhasil ditambahkan, fungsi entri driver akan menerima pesan driver ACM.

Sintaks

MMRESULT ACMAPI acmDriverAdd(
  LPHACMDRIVERID phadid,
  HINSTANCE      hinstModule,
  LPARAM         lParam,
  DWORD          dwPriority,
  DWORD          fdwAdd
);

Parameter

phadid

Penunjuk ke buffer yang menerima handel yang mengidentifikasi driver yang diinstal. Handel ini digunakan untuk mengidentifikasi driver dalam panggilan ke fungsi ACM lainnya.

hinstModule

Tangani ke instans modul yang pustaka executable atau dynamic-link (DLL) berisi fungsi entri driver.

lParam

Alamat fungsi driver atau handel jendela pemberitahuan, tergantung pada bendera fdwAdd .

dwPriority

Pesan jendela yang akan dikirim untuk siaran pemberitahuan. Parameter ini hanya digunakan dengan bendera ACM_DRIVERADDF_NOTIFYHWND. Semua bendera lain mengharuskan anggota ini diatur ke nol.

fdwAdd

Bendera untuk menambahkan driver ACM. Nilai berikut didefinisikan.

Nilai	Makna
ACM_DRIVERADDF_FUNCTION	Parameter lParam adalah alamat fungsi driver yang sesuai dengan prototipe acmDriverProc . Fungsi ini dapat berada di file yang dapat dieksekusi atau DLL.
ACM_DRIVERADDF_GLOBAL	Disediakan untuk kompatibilitas dengan aplikasi 16-bit. Untuk API Win32, driver ACM yang ditambahkan oleh fungsi acmDriverAdd hanya dapat digunakan oleh aplikasi yang menambahkan driver. Ini benar apakah ACM_DRIVERADDF_GLOBAL ditentukan atau tidak. Untuk informasi selengkapnya, lihat Menambahkan Driver Dalam Aplikasi.
ACM_DRIVERADDF_LOCAL	ACM secara otomatis memberikan prioritas driver lokal yang lebih tinggi daripada driver global saat mencari driver untuk memenuhi panggilan fungsi. Untuk informasi selengkapnya, lihat Menambahkan Driver Dalam Aplikasi.
ACM_DRIVERADDF_NAME	Parameter lParam adalah nama nilai registri dalam HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Drivers32. Nilai mengidentifikasi DLL yang mengimplementasikan codec ACM. Aplikasi dapat menggunakan bendera ini jika entri registri baru dibuat setelah aplikasi mulai menggunakan ACM.
ACM_DRIVERADDF_NOTIFYHWND	Parameter lParam adalah handel dari jendela pemberitahuan yang menerima pesan ketika perubahan pada prioritas dan status driver global dibuat. Pesan jendela yang akan diterima ditentukan oleh aplikasi dan harus diteruskan dalam dwPriority. Parameter wParam dan lParam yang diteruskan dengan pesan jendela disediakan untuk digunakan di masa mendatang dan harus diabaikan. ACM_DRIVERADDF_GLOBAL tidak dapat ditentukan bersama dengan bendera ini. Untuk informasi selengkapnya tentang prioritas driver, lihat deskripsi untuk fungsi acmDriverPriority .

Menampilkan nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya. Kemungkinan nilai kesalahan termasuk yang berikut ini.

Menampilkan kode	Deskripsi
MMSYSERR_INVALFLAG	Setidaknya satu bendera tidak valid.
MMSYSERR_INVALPARAM	Setidaknya satu parameter tidak valid.
MMSYSERR_NOMEM	Sistem tidak dapat mengalokasikan sumber daya.

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