Struktur ACMFILTERCHOOSE (msacm.h)

Struktur ACMFILTERCHOOSE berisi informasi yang digunakan ACM untuk menginisialisasi kotak dialog pemilihan filter waveform-audio yang ditentukan sistem. Setelah pengguna menutup kotak dialog, sistem mengembalikan informasi tentang pilihan pengguna dalam struktur ini.

Sintaks

typedef struct tACMFILTERCHOOSE {
  DWORD                   cbStruct;
  DWORD                   fdwStyle;
  HWND                    hwndOwner;
  LPWAVEFILTER            pwfltr;
  DWORD                   cbwfltr;
  LPCSTR                  pszTitle;
  char                    szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS];
  char                    szFilter[ACMFILTERDETAILS_FILTER_CHARS];
  LPSTR                   pszName;
  DWORD                   cchName;
  DWORD                   fdwEnum;
  LPWAVEFILTER            pwfltrEnum;
  HINSTANCE               hInstance;
  LPCSTR                  pszTemplateName;
  LPARAM                  lCustData;
  ACMFILTERCHOOSEHOOKPROC pfnHook;
} ACMFILTERCHOOSE, *PACMFILTERCHOOSE, *LPACMFILTERCHOOSE;

Anggota

cbStruct

Ukuran, dalam byte, dari struktur ACMFILTERCHOOSE . Anggota ini harus diinisialisasi sebelum aplikasi memanggil fungsi acmFilterChoose . Ukuran yang ditentukan dalam anggota ini harus cukup besar untuk memuat struktur ACMFILTERCHOOSE dasar.

fdwStyle

Bendera gaya opsional untuk fungsi acmFilterChoose . Anggota ini harus diinisialisasi ke kombinasi bendera berikut yang valid sebelum aplikasi memanggil fungsi acmFilterChoose . Nilai berikut didefinisikan:

hwndOwner

Tangani ke jendela yang memiliki kotak dialog. Anggota ini bisa menjadi handel jendela atau NULL yang valid jika kotak dialog tidak memiliki pemilik. Anggota ini harus diinisialisasi sebelum memanggil fungsi acmFilterChoose .

pwfltr

Arahkan ke struktur WAVEFILTER . Jika bendera ACMFILTERCHOOSE_STYLEF_INITTOFILTERSTRUCT ditentukan dalam anggota fdwStyle , struktur ini harus diinisialisasi ke filter yang valid. Ketika fungsi acmFilterChoose kembali, buffer ini berisi filter yang dipilih. Jika pengguna membatalkan kotak dialog, tidak ada perubahan yang akan dilakukan pada buffer ini.

cbwfltr

Ukuran, dalam byte, dari buffer yang diarahkan oleh anggota pwfltr . Fungsi acmFilterChoose mengembalikan ACMERR_NOTPOSSIBLE jika buffer terlalu kecil untuk berisi informasi filter; ACM juga menyalin ukuran yang diperlukan ke dalam anggota ini. Aplikasi dapat menggunakan fungsi acmMetrics dan acmFilterTagDetails untuk menentukan ukuran terbesar yang diperlukan untuk buffer ini.

pszTitle

Penunjuk ke string yang akan ditempatkan di bilah judul kotak dialog. Jika anggota ini NULL, ACM menggunakan judul default (yaitu, "Pemilihan Filter").

szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS]

Buffer yang berisi string yang dihentikan null yang menjelaskan tag filter pilihan filter saat struktur ACMFILTERTAGDETAILS dikembalikan oleh acmFilterTagDetails. Jika pengguna membatalkan kotak dialog, anggota ini akan berisi string yang dihentikan null.

szFilter[ACMFILTERDETAILS_FILTER_CHARS]

Buffer yang berisi string yang dihentikan null yang menjelaskan atribut filter pemilihan filter saat struktur ACMFILTERDETAILS dikembalikan oleh acmFilterDetails. Jika pengguna membatalkan kotak dialog, anggota ini akan berisi string yang dihentikan null.

pszName

Penunjuk ke string untuk nama filter yang ditentukan pengguna. Jika ini adalah string yang tidak dihentikan null, ACM mencoba mencocokkan nama dengan nama filter yang ditentukan pengguna yang sebelumnya disimpan. Jika kecocokan ditemukan, kotak dialog diinisialisasi ke filter tersebut. Jika kecocokan tidak ditemukan atau anggota ini adalah string yang dihentikan null, anggota ini diabaikan untuk input. Ketika fungsi acmFilterChoose kembali, buffer ini berisi string yang dihentikan null yang menjelaskan filter yang ditentukan pengguna. Jika nama filter tidak berjudul (yaitu, pengguna belum memberikan nama untuk filter), anggota ini akan menjadi string yang dihentikan null saat dikembalikan. Jika pengguna membatalkan kotak dialog, tidak ada perubahan yang akan dilakukan pada buffer ini.

Jika bendera ACMFILTERCHOOSE_STYLEF_INITTOFILTERSTRUCT ditentukan oleh anggota fdwStyle , anggota pszName diabaikan sebagai anggota input.

cchName

Ukuran, dalam karakter, dari buffer yang diidentifikasi oleh anggota pszName . Panjang buffer ini harus minimal 128 karakter. Jika pszNameNULL, anggota ini diabaikan.

fdwEnum

Bendera opsional untuk membatasi jenis filter yang tercantum dalam kotak dialog. Bendera ini identik dengan bendera fdwEnum untuk fungsi acmFilterEnum . Jika pwfltrEnumADALAH NULL, anggota ini harus nol.

pwfltrEnum

Penunjuk ke struktur WAVEFILTER yang akan digunakan untuk membatasi filter yang tercantum dalam kotak dialog. Anggota fdwEnum menentukan anggota struktur ini mana yang harus digunakan untuk pembatasan enumerasi. Anggota cbStruct dari struktur WAVEFILTER ini harus diinisialisasi ke ukuran struktur WAVEFILTER . Jika tidak ada batasan khusus yang diinginkan, anggota ini bisa NULL.

hInstance

Tangani ke blok data yang berisi templat kotak dialog yang ditentukan oleh anggota pszTemplateName . Anggota ini hanya digunakan jika anggota fdwStyle menentukan bendera ACMFILTERCHOOSE_STYLEF_ENABLETEMPLATE atau ACMFILTERCHOOSE_STYLEF_ENABLETEMPLATEHANDLE; jika tidak, anggota ini harus NULL pada input.

pszTemplateName

Penunjuk ke string yang dihentikan null yang menentukan nama file sumber daya untuk templat kotak dialog yang akan diganti untuk templat kotak dialog di ACM. Aplikasi dapat menggunakan makro MAKEINTRESOURCE untuk sumber daya kotak dialog bernomor. Anggota ini hanya digunakan jika anggota fdwStyle menentukan bendera ACMFILTERCHOOSE_STYLEF_ENABLETEMPLATE; jika tidak, anggota ini harus NULL pada input.

lCustData

Data yang ditentukan aplikasi yang diteruskan ACM ke fungsi kait yang diidentifikasi oleh anggota pfnHook . Sistem meneruskan data dalam parameter lParam dari pesan WM_INITDIALOG .

pfnHook

Arahkan ke fungsi panggilan balik yang memproses pesan yang ditujukan untuk kotak dialog. Aplikasi harus menentukan bendera ACMFILTERCHOOSE_STYLEF_ENABLEHOOK di anggota fdwStyle untuk mengaktifkan hook; jika tidak, anggota ini harus NULL. Fungsi hook harus mengembalikan FALSE untuk meneruskan pesan ke prosedur kotak dialog standar atau TRUE untuk membuang pesan. Jenis fungsi panggilan balik adalah acmFilterChooseHookProc.

Persyaratan

Lihat juga

ACMFILTERDETAILS

ACMFILTERTAGDETAILS

Pengelola Pemadatan Audio

Struktur Kompresi Audio

MAKEINTRESOURCE

MM_ACM_FILTERCHOOSE

RegisterWindowMessage

WAVEFILTER

WM_INITDIALOG

acmFilterChoose

acmFilterDetails

acmFilterEnum

acmFilterTagDetails

acmMetrics