acmStreamUnprepareHeader 関数 (msacm.h)
acmStreamUnprepareHeader 関数は、ACM ストリームの acmStreamPrepareHeader 関数によって実行される準備をクリーンアップします。 この関数は、指定されたバッファーで ACM が終了した後に呼び出す必要があります。 アプリケーションは、ソースバッファーと宛先バッファーを解放する前に、この関数を呼び出す必要があります。
構文
MMRESULT ACMAPI acmStreamUnprepareHeader(
HACMSTREAM has,
LPACMSTREAMHEADER pash,
DWORD fdwUnprepare
);
パラメーター
has
変換蒸気に取り扱います。
pash
準備されていないソース バッファーと宛先バッファーを識別する ACMSTREAMHEADER 構造体へのポインター。
fdwUnprepare
予約;は 0 である必要があります。
戻り値
成功した場合は 0 を返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
pash で指定されたストリーム ヘッダーは現在使用中であり、準備を解除することはできません。 |
|
現在、pash で指定されたストリーム ヘッダーは、acmStreamPrepareHeader 関数によって準備されていません。 |
|
少なくとも 1 つのフラグが無効です。 |
|
指定されたハンドルが無効です。 |
|
少なくとも 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 |