acmFormatDetails 関数 (msacm.h)

  • [アーティクル]

acmFormatDetails 関数は、特定の波形オーディオ形式タグの形式の詳細について ACM に対してクエリを実行します。

構文

MMRESULT ACMAPI acmFormatDetails(
  HACMDRIVER         had,
  LPACMFORMATDETAILS pafd,
  DWORD              fdwDetails
);

パラメーター

had

ACM ドライバーを処理して、形式タグの波形オーディオ形式の詳細を照会します。 このパラメーターが NULL の場合、ACM は最初の適切な ACM ドライバーの詳細を使用します。

pafd

指定された書式タグの書式の詳細を格納する ACMFORMATDETAILS 構造体へのポインター。

fdwDetails

波形オーディオ形式タグの詳細を取得するためのフラグ。 次の値が定義されています。

[ACMFORMATDETAILS]() 構造体が指定され、残りの詳細を返す必要があります。 ACMFORMATDETAILS 構造体の dwFormatTag メンバーは、pwfx が指定したのと同じ書式タグに初期化する必要があります。 このクエリ型を使用すると、任意の書式構造の文字列記述を取得できます。 アプリケーションで had の ACM ドライバー ハンドルが指定されている 場合、そのドライバーの形式の詳細が返されます。 アプリケーションで had に NULL が指定されている場合、ACM は、詳細を返す最初の許容されるドライバーを見つけます。
値 意味
ACM_FORMATDETAILSF_FORMAT
ACM_FORMATDETAILSF_INDEX ACMFORMATDETAILS 構造体の dwFormatIndex メンバーに、書式タグの書式インデックスが指定されました。 形式の詳細は、 pafd によって定義された構造体で返されます。 インデックスの範囲は、書式タグの ACMFORMATTAGDETAILS 構造体で返される cStandardFormats メンバーより 0 から 1 未満です。 アプリケーションでは、このフラグを使用して形式の詳細を取得するときに 、 の ドライバー ハンドルを指定する必要があります。 この関数を呼び出す前に初期化する必要があるメンバーについては、 ACMFORMATDETAILS 構造体を参照してください。

戻り値

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

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

要件

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

こちらもご覧ください

オーディオ圧縮関数

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