fungsi acmDriverAddW (msacm.h)

Artikel
11/20/2024

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.

Sintaksis

MMRESULT ACMAPI acmDriverAddW(
  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 dapat dieksekusi atau pustaka tautan dinamis (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 ditentukan.

Nilai	Arti
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 lebih tinggi kepada driver lokal 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 di 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 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 dicadangkan 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 .

Mengembalikan nilai

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

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

Komentar

Nota

Header msacm.h mendefinisikan acmDriverAdd sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

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

Lihat juga

Fungsi Kompresi Audio

Pengelola Kompresi Audio

Bagikan melalui