fungsi acmFormatTagEnumW (msacm.h)

Artikel
11/20/2024

Fungsi acmFormatTagEnum menghitung tag format waveform-audio yang tersedia dari driver ACM. Fungsi ini terus menghitung sampai tidak ada tag format yang lebih cocok atau fungsi panggilan balik mengembalikan FALSE.

Sintaksis

MMRESULT ACMAPI acmFormatTagEnumW(
  HACMDRIVER             had,
  LPACMFORMATTAGDETAILSW paftd,
  ACMFORMATTAGENUMCBW    fnCallback,
  DWORD_PTR              dwInstance,
  DWORD                  fdwEnum
);

Parameter

had

Tangani ke driver ACM untuk mengkueri detail tag format waveform-audio. Jika parameter ini NULL, ACM menggunakan detail dari driver ACM pertama yang sesuai.

paftd

Arahkan ke struktur ACMFORMATTAGDETAILS yaitu menerima detail tag format yang diteruskan ke fungsi yang ditentukan dalam fnCallback. Struktur ini harus memiliki cbStruct anggota struktur ACMFORMATTAGDETAILS diinisialisasi.

fnCallback

Alamat instans prosedur dari fungsi panggilan balik yang ditentukan aplikasi.

dwInstance

Nilai yang ditentukan aplikasi 64-bit (DWORD_PTR) atau 32-bit (DWORD) yang diteruskan ke fungsi panggilan balik bersama dengan detail tag format ACM.

fdwEnum

Dipesan; harus nol.

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_INVALHANDLE	Handel yang ditentukan tidak valid.
MMSYSERR_INVALPARAM	Setidaknya satu parameter tidak valid.

Komentar

Fungsi ini akan mengembalikan MMSYSERR_NOERROR (nol) jika tidak ada driver ACM yang cocok yang diinstal. Selain itu, fungsi panggilan balik tidak akan dipanggil.

Nota

Header msacm.h mendefinisikan acmFormatTagEnum sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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