acmStreamSize 関数 (msacm.h)

  • [アーティクル]

acmStreamSize 関数は、ACM ストリーム上のソース バッファーまたは宛先バッファーに推奨されるサイズを返します。

構文

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

パラメーター

has

変換ストリームへのハンドル。

cbInput

ソースバッファーまたはコピー先バッファーのサイズ (バイト単位)。 fdwSize フラグは、入力パラメーターが定義する内容を指定します。 このパラメーターは 0 以外である必要があります。

pdwOutputBytes

ソースバッファーまたはコピー先バッファーのサイズ (バイト単位) を含む変数へのポインター。 fdwSize フラグは、出力パラメーターが定義する内容を指定します。 acmStreamSize 関数が成功した場合、この場所には常に 0 以外の値が入力されます。

fdwSize

ストリーム サイズ クエリのフラグ。 次の値が定義されています。

値 意味
ACM_STREAMSIZEF_DESTINATION cbInput パラメーターには、コピー先バッファーのサイズが含まれています。 pdwOutputBytes パラメーターは、推奨されるソース バッファー サイズ (バイト単位) を受け取ります。
ACM_STREAMSIZEF_SOURCE cbInput パラメーターには、ソース バッファーのサイズが含まれています。 pdwOutputBytes パラメーターは、推奨される宛先バッファー サイズ (バイト単位) を受け取ります。

戻り値

成功した場合は 0 を返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。

リターン コード 説明
ACMERR_NOTPOSSIBLE
 要求された操作を実行できません。
MMSYSERR_INVALFLAG
 少なくとも 1 つのフラグが無効です。
MMSYSERR_INVALHANDLE
 指定されたハンドルが無効です。
MMSYSERR_INVALPARAM
 少なくとも 1 つのパラメーターが無効です。

注釈

アプリケーションでは、この関数を使用して、ソース バッファーまたは宛先バッファーに推奨されるバッファー サイズを決定できます。 返されるバッファー サイズは、変換に必要な実際のサイズの見積もりにすぎません。 実際の変換サイズは、変換を実行せずに常に決定できるとは限らないため、通常、返されるサイズは過大評価されます。

エラーが発生した場合、 pdwOutputBytes が指す場所は 0 を受け取ります。 これは、 pdwOutputBytes で指定されたポインターが有効であることを前提としています。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー msacm.h
Library Msacm32.lib
[DLL] Msacm32.dll

こちらもご覧ください

オーディオ圧縮関数

オーディオ圧縮マネージャー