acmStreamConvert 関数 (msacm.h)

acmStreamConvert 関数は、指定された変換ストリームに対して変換を実行するように ACM に要求します。ストリームの開き方によっては、変換が同期または非同期になる場合があります。

構文

MMRESULT ACMAPI acmStreamConvert(
  HACMSTREAM        has,
  LPACMSTREAMHEADER pash,
  DWORD             fdwConvert
);

has

開いている変換ストリームへのハンドル。

pash

変換のソースバッファーと変換先バッファーを記述するストリームヘッダーへのポインター。このヘッダーは、 acmStreamPrepareHeader 関数を使用して以前に準備しておく必要があります。

fdwConvert

変換を実行するためのフラグ。次の値が定義されています。

値	説明
ACM_STREAMCONVERTF_BLOCKALIGN	ブロックの整数のみが変換されます。変換されたデータは、ブロックアライン境界で終了します。ブロックアライン変換先に変換するのに十分なソースデータが存在しない限り、アプリケーションはストリーム上のすべての変換にこのフラグを使用する必要があります。この場合、このフラグを指定せずに最後の変換を指定する必要があります。
ACM_STREAMCONVERTF_END	ACM 変換ストリームは、保留中のインスタンスデータの返しを開始する必要があります。たとえば、変換ストリームにエコーフィルター操作の終了などのインスタンスデータが保持されている場合、このフラグにより、ストリームはオプションのソースデータを含む残りのデータの返しを開始します。このフラグは、ACM_STREAMCONVERTF_START フラグで指定できます。
ACM_STREAMCONVERTF_START	ACM 変換ストリームは、そのインスタンスデータを再初期化する必要があります。たとえば、変換ストリームにデルタや予測情報などのインスタンスデータが保持されている場合、このフラグはストリームを開始の既定値に復元します。このフラグは、ACM_STREAMCONVERTF_END フラグで指定できます。

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

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

acmStreamConvert に渡される前に、acmStreamPrepareHeader 関数を使用してソースバッファーと宛先バッファーを準備する必要があります。

非同期変換要求が ACM またはドライバーによって正常にキューに入れられ、その変換が後で不可能と判断された場合、 aCMSTREAMHEADER 構造体は cbDstLengthUsed メンバーがゼロに設定された状態でアプリケーションのコールバック関数にポストバックされます。


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