ACMFORMATTAGDETAILS 構造体 (msacm.h)
ACMFORMATTAGDETAILS 構造体は、ACM ドライバーの波形オーディオ形式タグの詳細を示します。
構文
typedef struct tACMFORMATTAGDETAILS {
DWORD cbStruct;
DWORD dwFormatTagIndex;
DWORD dwFormatTag;
DWORD cbFormatSize;
DWORD fdwSupport;
DWORD cStandardFormats;
char szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS];
} ACMFORMATTAGDETAILS, *PACMFORMATTAGDETAILS, *LPACMFORMATTAGDETAILS;
メンバー
cbStruct
ACMFORMATTAGDETAILS 構造体のサイズ (バイト単位)。 このメンバーは、アプリケーションが acmFormatTagDetails または acmFormatTagEnum 関数を 呼び出す前に初期化する必要があります。 このメンバーによって指定されるサイズは、基本 ACMFORMATTAGDETAILS 構造体を含むのに十分な大きさである必要があります。 acmFormatTagDetails 関数が返されると、このメンバーには、返される情報の実際のサイズが含まれます。 返される情報は、要求されたサイズを超えることはありません。
dwFormatTagIndex
詳細を取得する書式タグのインデックス。 インデックスの範囲は、ACM ドライバーでサポートされている書式タグの数よりも 0 から 1 未満です。 ドライバーでサポートされている書式タグの数は、 ACMDRIVERDETAILS 構造体に含まれています。 dwFormatTagIndex メンバーは、インデックスによってドライバーの書式タグの詳細に対してクエリを実行する場合にのみ使用されます。それ以外の場合、このメンバーは 0 である必要があります。
dwFormatTag
ACMFORMATTAGDETAILS 構造体が記述する波形オーディオ形式タグ。 このメンバーは、ACM_FORMATTAGDETAILSF_FORMATTAG および ACM_FORMATTAGDETAILSF_LARGESTSIZE クエリ フラグの入力に使用されます。 acmFormatTagDetails 関数が成功した場合、このメンバーは常に返されます。 このメンバーは、他のすべてのクエリ フラグに対してWAVE_FORMAT_UNKNOWNに設定する必要があります。
cbFormatSize
dwFormatTag 型の波形オーディオ形式の最大合計サイズ (バイト単位)。 たとえば、このメンバーは、WAVE_FORMAT_PCMの場合は 16、WAVE_FORMAT_ADPCMの場合は 50 になります。
fdwSupport
書式タグに固有のドライバーサポート フラグ。 これらのフラグは 、ACMDRIVERDETAILS 構造体と同じです。 このメンバーは、次の値の組み合わせである場合があり、ドライバーがサポートする操作を format タグと共に参照します。
| Name | 説明 |
|---|---|
|
ドライバーでは、指定した書式タグを使用した非同期変換がサポートされています。 |
|
ドライバーでは、2 つの異なる形式タグ間の変換がサポートされています。ここで、いずれかのタグが指定された書式タグです。 たとえば、ドライバーがWAVE_FORMAT_PCMからWAVE_FORMAT_ADPCMへの圧縮をサポートしている場合、このフラグが設定されます。 |
|
ドライバーは、指定された書式タグの 2 つの異なる形式間の変換をサポートしています。 たとえば、ドライバーがWAVE_FORMAT_PCMのリサンプリングをサポートしている場合、このフラグが設定されます。 |
|
ドライバーはフィルターをサポートしています (形式属性を変更せずにデータを変更します)。 たとえば、ドライバーが指定したフォーマット タグでボリュームまたはエコー操作をサポートしている場合、このフラグが設定されます。 |
|
ドライバーは、波形オーディオ デバイスを介して指定されたフォーマット タグのハードウェア入力、出力、または両方をサポートします。 アプリケーションでは、ACM_METRIC_HARDWARE_WAVE_INPUTとACM_METRIC_HARDWARE_WAVE_OUTPUTメトリック インデックスで acmMetrics 関数を使用して、サポートする ACM ドライバーに関連付けられている波形オーディオ デバイス識別子を取得する必要があります。 |
cStandardFormats
dwFormatTag 型の標準書式の数。つまり、すべてのサンプル レート、サンプルあたりのビット数、チャネルなどの組み合わせです。 この値は、ドライバーでサポートされているすべての形式を指定できますが、必ずしも指定する必要はありません。
szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS]
dwFormatTag 型を表す文字列。 acmFormatTagDetails 関数が成功した場合、この文字列は常に返されます。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| Header | msacm.h |