acmFormatTagEnum 関数 (msacm.h)
acmFormatTagEnum 関数は、ACM ドライバーから使用可能な波形オーディオ形式タグを列挙します。 この関数は、適切な書式タグが存在しないか、コールバック関数が FALSE を返すまで列挙を続けます。
構文
MMRESULT ACMAPI acmFormatTagEnum(
HACMDRIVER had,
LPACMFORMATTAGDETAILS paftd,
ACMFORMATTAGENUMCB fnCallback,
DWORD_PTR dwInstance,
DWORD fdwEnum
);
パラメーター
had
ACM ドライバーにハンドルして、波形オーディオ形式のタグの詳細を照会します。 このパラメーターが NULL の場合、ACM は最初の適切な ACM ドライバーの詳細を使用します。
paftd
fnCallback で指定された関数に渡される書式タグの詳細を受け取る ACMFORMATTAGDETAILS 構造体へのポインター。 この構造体には、ACMFORMATTAGDETAILS 構造体の cbStruct メンバーが初期化されている必要があります。
fnCallback
アプリケーション定義コールバック関数のプロシージャ インスタンス アドレス。
dwInstance
ACM 形式のタグの詳細と共にコールバック関数に渡される 64 ビット (DWORD_PTR) または 32 ビット (DWORD) アプリケーション定義値。
fdwEnum
予約;は 0 である必要があります。
戻り値
成功した場合は 0 を返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。
リターン コード | 説明 |
---|---|
|
少なくとも 1 つのフラグが無効です。 |
|
指定されたハンドルが無効です。 |
|
少なくとも 1 つのパラメーターが無効です。 |
注釈
適切な ACM ドライバーがインストールされていない場合、この関数は MMSYSERR_NOERROR (ゼロ) を返します。 さらに、コールバック関数は呼び出されません。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | msacm.h |
Library | Msacm32.lib |
[DLL] | Msacm32.dll |