fungsi acmDriverPriority (msacm.h)

Artikel
08/24/2023

Fungsi acmDriverPriority memodifikasi prioritas dan status driver ACM.

Sintaks

MMRESULT ACMAPI acmDriverPriority(
  HACMDRIVERID hadid,
  DWORD        dwPriority,
  DWORD        fdwPriority
);

Parameter

hadid

Tangani ke pengidentifikasi driver driver ACM yang diinstal. Jika bendera ACM_DRIVERPRIORITYF_BEGIN dan ACM_DRIVERPRIORITYF_END ditentukan, parameter ini harus NULL.

dwPriority

Prioritas baru untuk pengidentifikasi driver ACM global. Nilai nol menentukan bahwa prioritas pengidentifikasi driver harus tetap tidak berubah. Nilai 1 menentukan bahwa driver harus ditempatkan sebagai driver prioritas pencarian tertinggi. Nilai –1 menentukan bahwa driver harus ditempatkan sebagai driver prioritas pencarian terendah. Prioritas hanya digunakan untuk pendorong global.

fdwPriority

Bendera untuk mengatur prioritas driver ACM. Nilai berikut didefinisikan.

Nilai	Makna
ACM_DRIVERPRIORITYF_BEGIN	Mengubah siaran pemberitahuan harus ditangguhkan. Aplikasi harus mengaktifkan kembali siaran pemberitahuan sesegera mungkin dengan bendera ACM_DRIVERPRIORITYF_END. Perhatikan bahwa hadid harus NULL, dwPriority harus nol, dan hanya bendera ACM_DRIVERPRIORITYF_BEGIN yang dapat diatur.
ACM_DRIVERPRIORITYF_DISABLE	Driver ACM harus dinonaktifkan jika saat ini diaktifkan. Menonaktifkan driver yang dinonaktifkan tidak melakukan apa pun.
ACM_DRIVERPRIORITYF_ENABLE	Driver ACM harus diaktifkan jika saat ini dinonaktifkan. Mengaktifkan driver yang diaktifkan tidak melakukan apa pun.
ACM_DRIVERPRIORITYF_END	Tugas panggilan ingin mengaktifkan kembali perubahan siaran pemberitahuan. Aplikasi harus memanggil acmDriverPriority dengan ACM_DRIVERPRIORITYF_END untuk setiap panggilan yang berhasil dengan bendera ACM_DRIVERPRIORITYF_BEGIN. Perhatikan bahwa hadid harus NULL, dwPriority harus nol, dan hanya bendera ACM_DRIVERPRIORITYF_END yang dapat diatur.

Nilai kembali

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

Menampilkan kode	Deskripsi
MMSYSERR_ALLOCATED	Kunci siaran yang ditangguhkan dimiliki oleh tugas yang berbeda.
MMSYSERR_INVALFLAG	Setidaknya satu bendera tidak valid.
MMSYSERR_INVALHANDLE	Handel yang ditentukan tidak valid.
MMSYSERR_INVALPARAM	Setidaknya satu parameter tidak valid.
MMSYSERR_NOTSUPPORTED	Operasi yang diminta tidak didukung untuk driver yang ditentukan. Misalnya, pengidentifikasi lokal dan memberi tahu pengidentifikasi driver tidak mendukung prioritas (tetapi dapat diaktifkan dan dinonaktifkan). Jika aplikasi menentukan nilai bukan nol untuk dwPriority untuk pengidentifikasi lokal dan memberi tahu pengidentifikasi driver, kesalahan ini akan dikembalikan.

Keterangan

Semua pengidentifikasi driver dapat diaktifkan dan dinonaktifkan, termasuk pengidentifikasi driver global, lokal, dan pemberitahuan.

Jika lebih dari satu pengidentifikasi driver global perlu diaktifkan, dinonaktifkan, atau digeser dalam prioritas, aplikasi harus menunda mengubah siaran pemberitahuan dengan menggunakan bendera ACM_DRIVERPRIORITYF_BEGIN. Satu pemberitahuan perubahan akan disiarkan saat bendera ACM_DRIVERPRIORITYF_END ditentukan.

Aplikasi dapat menggunakan fungsi dengan acmMetrics ACM_METRIC_DRIVER_PRIORITY indeks metrik untuk mengambil prioritas driver global saat ini. Driver selalu dijumlahkan dari prioritas tertinggi hingga terendah oleh fungsi acmDriverEnum .

Semua pengidentifikasi driver yang diaktifkan akan menerima pemberitahuan perubahan. Aplikasi dapat mendaftarkan pesan pemberitahuan dengan menggunakan fungsi acmDriverAdd bersama dengan bendera ACM_DRIVERADDF_NOTIFYHWND. Perubahan pada pengidentifikasi driver nonglobal tidak akan disiarkan.

Prioritas hanya digunakan untuk urutan pencarian ketika aplikasi tidak menentukan driver. Meningkatkan prioritas driver tidak akan berpengaruh pada performa driver.

Persyaratan

Persyaratan	Nilai
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