acmStreamUnprepareHeader 関数 (msacm.h)

  • [アーティクル]

acmStreamUnprepareHeader 関数は、ACM ストリームの acmStreamPrepareHeader 関数によって実行される準備をクリーンアップします。 この関数は、指定されたバッファーで ACM が終了した後に呼び出す必要があります。 アプリケーションは、ソースバッファーと宛先バッファーを解放する前に、この関数を呼び出す必要があります。

構文

MMRESULT ACMAPI acmStreamUnprepareHeader(
  HACMSTREAM        has,
  LPACMSTREAMHEADER pash,
  DWORD             fdwUnprepare
);

パラメーター

has

変換蒸気に取り扱います。

pash

準備されていないソース バッファーと宛先バッファーを識別する ACMSTREAMHEADER 構造体へのポインター。

fdwUnprepare

予約;は 0 である必要があります。

戻り値

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

リターン コード 説明
ACMERR_BUSY
 pash で指定されたストリーム ヘッダーは現在使用中であり、準備を解除することはできません。
ACMERR_UNPREPARED
 現在、pash で指定されたストリーム ヘッダーは、acmStreamPrepareHeader 関数によって準備されていません。
MMSYSERR_INVALFLAG
 少なくとも 1 つのフラグが無効です。
MMSYSERR_INVALHANDLE
 指定されたハンドルが無効です。
MMSYSERR_INVALPARAM
 少なくとも 1 つのパラメーターが無効です。

解説

既に準備されていないストリーム ヘッダーの準備を解除すると、エラーになります。 アプリケーションでは、対応する acmStreamPrepareHeader の呼び出し中に使用されたソースバッファーと宛先バッファーの長さ (cbSrcLength と cbDstLength それぞれ) を指定する必要があります。 これらのメンバー値をリセットしないと、 acmStreamUnprepareHeader がMMSYSERR_INVALPARAM エラーで失敗します。

ACM は、いくつかのエラーから復旧できます。 ACM は 0 以外のエラーを返しますが、ストリーム ヘッダーは適切に準備されていません。 ストリーム ヘッダーが実際に準備されていないかどうかを判断するために、アプリケーションは ACMSTREAMHEADER_STATUSF_PREPARED フラグを調べることができます。 acmStreamUnprepareHeader が成功を返した場合、ヘッダーは常に準備解除されます。

要件

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

関連項目

オーディオ圧縮関数

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