fungsi acmMetrics (msacm.h)
Fungsi acmMetrics mengembalikan berbagai metrik untuk ACM atau objek ACM terkait.
Sintaks
MMRESULT ACMAPI acmMetrics(
HACMOBJ hao,
UINT uMetric,
LPVOID pMetric
);
Parameter
hao
Tangani ke objek ACM untuk mengkueri metrik yang ditentukan dalam uMetric. Untuk beberapa kueri, parameter ini bisa NULL.
uMetric
Indeks metrik yang akan dikembalikan dalam pMetric.
| Nilai | Makna |
|---|---|
| ACM_METRIC_COUNT_CODECS | Nilai yang dikembalikan adalah jumlah kompresor ACM global atau driver dekompresor dalam sistem. Parameter hao harus NULL untuk indeks metrik ini. Parameter pMetric harus menunjuk ke buffer ukuran yang sama dengan nilai DWORD . |
| ACM_METRIC_COUNT_CONVERTERS | Nilai yang dikembalikan adalah jumlah driver konverter ACM global dalam sistem. Parameter hao harus NULL untuk indeks metrik ini. Parameter pMetric harus menunjuk ke buffer ukuran yang sama dengan nilai DWORD . |
| ACM_METRIC_COUNT_DISABLED | Nilai yang dikembalikan adalah jumlah total driver ACM global yang dinonaktifkan (dari semua jenis dukungan) dalam sistem. Parameter hao harus NULL untuk indeks metrik ini. Parameter pMetric harus menunjuk ke buffer ukuran yang sama dengan nilai DWORD . Jumlah indeks metrik ACM_METRIC_COUNT_DRIVERS dan ACM_METRIC_COUNT_DISABLED adalah jumlah total driver ACM yang diinstal secara global. |
| ACM_METRIC_COUNT_DRIVERS | Nilai yang dikembalikan adalah jumlah total driver ACM global yang diaktifkan (dari semua jenis dukungan) dalam sistem. Parameter hao harus NULL untuk indeks metrik ini. Parameter pMetric harus menunjuk ke buffer ukuran yang sama dengan nilai DWORD . |
| ACM_METRIC_COUNT_FILTERS | Nilai yang dikembalikan adalah jumlah driver filter ACM global dalam sistem. Parameter hao harus NULL untuk indeks metrik ini. Parameter pMetric harus menunjuk ke buffer ukuran yang sama dengan nilai DWORD . |
| ACM_METRIC_COUNT_HARDWARE | Nilai yang dikembalikan adalah jumlah driver perangkat keras ACM global dalam sistem. Parameter hao harus NULL untuk indeks metrik ini. Parameter pMetric harus menunjuk ke buffer ukuran yang sama dengan nilai DWORD . |
| ACM_METRIC_COUNT_LOCAL_CODECS | Nilai yang dikembalikan adalah jumlah driver kompresor ACM lokal, driver dekompresor ACM, atau keduanya untuk tugas panggilan. Parameter hao harus NULL untuk indeks metrik ini. Parameter pMetric harus menunjuk ke buffer ukuran yang sama dengan nilai DWORD . |
| ACM_METRIC_COUNT_LOCAL_CONVERTERS | Nilai yang dikembalikan adalah jumlah driver konverter ACM lokal untuk tugas panggilan. Parameter hao harus NULL untuk indeks metrik ini. Parameter pMetric harus menunjuk ke buffer ukuran yang sama dengan nilai DWORD . |
| ACM_METRIC_COUNT_LOCAL_DISABLED | Nilai yang dikembalikan adalah jumlah total driver ACM lokal yang dinonaktifkan, dari semua jenis dukungan, untuk tugas panggilan. Parameter hao harus NULL untuk indeks metrik ini. Parameter pMetric harus menunjuk ke buffer ukuran yang sama dengan nilai DWORD . Jumlah indeks metrik ACM_METRIC_COUNT_LOCAL_DRIVERS dan ACM_METRIC_COUNT_LOCAL_DISABLED adalah jumlah total driver ACM yang diinstal secara lokal. |
| ACM_METRIC_COUNT_LOCAL_DRIVERS | Nilai yang dikembalikan adalah jumlah total driver ACM lokal yang diaktifkan (dari semua jenis dukungan) untuk tugas panggilan. Parameter hao harus NULL untuk indeks metrik ini. Parameter pMetric harus menunjuk ke buffer ukuran yang sama dengan nilai DWORD . |
| ACM_METRIC_COUNT_LOCAL_FILTERS | Nilai yang dikembalikan adalah jumlah driver filter ACM lokal untuk tugas panggilan. Parameter hao harus NULL untuk indeks metrik ini. Parameter pMetric harus menunjuk ke buffer ukuran yang sama dengan nilai DWORD . |
| ACM_METRIC_DRIVER_PRIORITY | Nilai yang dikembalikan adalah prioritas saat ini untuk driver yang ditentukan. Parameter hao harus merupakan pengidentifikasi driver ACM yang valid dari jenis data HACMDRIVERID . Parameter pMetric harus menunjuk ke buffer ukuran yang sama dengan nilai DWORD . |
| ACM_METRIC_DRIVER_SUPPORT | Nilai yang dikembalikan adalah bendera fdwSupport untuk driver yang ditentukan. Parameter hao harus merupakan pengidentifikasi driver ACM yang valid dari jenis data HACMDRIVERID . Parameter pMetric harus menunjuk ke buffer ukuran yang sama dengan nilai DWORD . |
| ACM_METRIC_HARDWARE_WAVE_INPUT | Nilai yang dikembalikan adalah pengidentifikasi perangkat input waveform-audio yang terkait dengan driver yang ditentukan. Parameter hao harus merupakan pengidentifikasi driver ACM yang valid dari jenis data HACMDRIVERID yang mendukung bendera ACMDRIVERDETAILS_SUPPORTF_HARDWARE. Jika tidak ada perangkat input waveform-audio yang terkait dengan driver, MMSYSERR_NOTSUPPORTED dikembalikan. Parameter pMetric harus menunjuk ke buffer ukuran yang sama dengan nilai DWORD . |
| ACM_METRIC_HARDWARE_WAVE_OUTPUT | Nilai yang dikembalikan adalah pengidentifikasi perangkat output waveform-audio yang terkait dengan driver yang ditentukan. Parameter hao harus merupakan pengidentifikasi driver ACM yang valid dari jenis data HACMDRIVERID yang mendukung bendera ACMDRIVERDETAILS_SUPPORTF_HARDWARE. Jika tidak ada perangkat output waveform-audio yang terkait dengan driver, MMSYSERR_NOTSUPPORTED dikembalikan. Parameter pMetric harus menunjuk ke buffer ukuran yang sama dengan nilai DWORD . |
| ACM_METRIC_MAX_SIZE_FILTER | Nilai yang dikembalikan adalah ukuran struktur WAVEFILTER terbesar. Jika hao adalah NULL, nilai yang dikembalikan adalah struktur WAVEFILTER terbesar dalam sistem. Jika hao mengidentifikasi instans terbuka driver ACM dari jenis data HACMDRIVER atau pengidentifikasi driver ACM dari jenis data HACMDRIVERID , struktur WAVEFILTER terbesar untuk driver tersebut dikembalikan. Parameter pMetric harus menunjuk ke buffer ukuran yang sama dengan nilai DWORD . Metrik ini tidak diizinkan untuk handel aliran ACM dari jenis data HACMSTREAM . |
| ACM_METRIC_MAX_SIZE_FORMAT | Nilai yang dikembalikan adalah ukuran struktur WAVEFORMATEX terbesar. Jika hao adalah NULL, nilai yang dikembalikan adalah struktur WAVEFORMATEX terbesar dalam sistem. Jika hao mengidentifikasi instans terbuka driver ACM dari jenis data HACMDRIVER atau pengidentifikasi driver ACM dari jenis data HACMDRIVERID , struktur WAVEFORMATEX terbesar untuk driver tersebut dikembalikan. Parameter pMetric harus menunjuk ke buffer ukuran yang sama dengan nilai DWORD . Metrik ini tidak diizinkan untuk handel aliran ACM dari jenis data HACMSTREAM . |
pMetric
Arahkan ke buffer untuk menerima detail metrik. Definisi yang tepat tergantung pada indeks uMetric .
Nilai kembali
Mengembalikan nol jika berhasil atau kesalahan sebaliknya. Kemungkinan nilai kesalahan termasuk yang berikut ini.
| Menampilkan kode | Deskripsi |
|---|---|
|
Indeks yang ditentukan dalam uMetric tidak dapat dikembalikan untuk hao yang ditentukan. |
|
Handel yang ditentukan tidak valid. |
|
Setidaknya satu parameter tidak valid. |
|
Indeks yang ditentukan dalam uMetric tidak didukung. |
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 |