fungsi acmStreamSize (msacm.h)

Artikel
08/24/2023

Fungsi acmStreamSize mengembalikan ukuran yang direkomendasikan untuk buffer sumber atau tujuan pada aliran ACM.

Sintaks

MMRESULT ACMAPI acmStreamSize(
  HACMSTREAM has,
  DWORD      cbInput,
  LPDWORD    pdwOutputBytes,
  DWORD      fdwSize
);

Parameter

has

Tangani ke aliran konversi.

cbInput

Ukuran, dalam byte, dari buffer sumber atau tujuan. Bendera fdwSize menentukan apa yang ditentukan parameter input. Parameter ini harus bukan nol.

pdwOutputBytes

Penunjuk ke variabel yang berisi ukuran, dalam byte, dari buffer sumber atau tujuan. Bendera fdwSize menentukan apa yang ditentukan parameter output. Jika fungsi acmStreamSize berhasil, lokasi ini akan selalu diisi dengan nilai bukan nol.

fdwSize

Bendera untuk kueri ukuran aliran. Nilai berikut didefinisikan:

Nilai	Makna
ACM_STREAMSIZEF_DESTINATION	Parameter cbInput berisi ukuran buffer tujuan. Parameter pdwOutputBytes akan menerima ukuran buffer sumber yang direkomendasikan, dalam byte.
ACM_STREAMSIZEF_SOURCE	Parameter cbInput berisi ukuran buffer sumber. Parameter pdwOutputBytes akan menerima ukuran buffer tujuan yang direkomendasikan, dalam byte.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
ACMERR_NOTPOSSIBLE	Operasi yang diminta tidak dapat dilakukan.
MMSYSERR_INVALFLAG	Setidaknya satu bendera tidak valid.
MMSYSERR_INVALHANDLE	Handel yang ditentukan tidak valid.
MMSYSERR_INVALPARAM	Setidaknya satu parameter tidak valid.

Keterangan

Aplikasi dapat menggunakan fungsi ini untuk menentukan ukuran buffer yang disarankan untuk buffer sumber atau tujuan. Ukuran buffer yang dikembalikan mungkin hanya estimasi dari ukuran aktual yang diperlukan untuk konversi. Karena ukuran konversi aktual tidak selalu dapat ditentukan tanpa melakukan konversi, ukuran yang dikembalikan biasanya akan dianggap berlebihan.

Jika terjadi kesalahan, lokasi yang diarahkan oleh pdwOutputBytes akan menerima nol. Ini mengasumsikan bahwa pointer yang ditentukan oleh pdwOutputBytes valid.

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