ACX_PEAKMETER_CONFIG 構造体 (acxelements.h)
ACX_PEAKMETER_CONFIG構造体は、ACX ピークメーター構成を定義するために使用されます。
構文
typedef struct _ACX_PEAKMETER_CONFIG {
ULONG Size;
ULONG Id;
const GUID *Name;
ULONG Flags;
ULONG ChannelsCount;
LONG Maximum;
LONG Minimum;
ULONG SteppingDelta;
PACX_PEAKMETER_CALLBACKS Callbacks;
} ACX_PEAKMETER_CONFIG, *PACX_PEAKMETER_CONFIG;
メンバー
Size
この構造体の長さ (バイト単位)。
Id
要素 ID を表す数値。
Name
要素の名前を表す GUID へのポインター。 既定値は KSAUDFNAME_PEAKMETER (存在しない場合) です。
Flags
ACX_PEAKMETER_CONFIG_FLAGS列挙型によって定義された ACX ピークメーター構成フラグ。
フラグ ビットは現在定義されていません。 このメンバーを 0 - AcxPeakMeterConfigNoFlags に設定します。
ChannelsCount
チャンネル数。 これは 1 から始まるカウントです。
Maximum
ピークメーターの最大値。 SignedMaximum は、LONG_MAXに設定する必要があります。
Minimum
ピークメーターの最小値。 SignedMinimum をLONG_MINに設定する必要があります。
SteppingDelta
ピークメーターのステップ値。
Callbacks
ACX オーディオ エンジンストリーミング操作のドライバー コールバックを識別する ACX_PEAKMETER_CALLBACKS構造体 。
注釈
たとえば、負のピークと正のピークがそれぞれ -1 と +1 の波形 (-1 から +1 までのスケール) がある場合、ピークメーター値LONG_MAXは、特定の時間枠の最大波形値を正確に報告します。 逆に、ゼロ (0) のピーク メーター値を使用して、すべての波形の値が 0 である無音状態を報告する必要があります。 ただし、ピーク値がゼロ (0) からLONG_MAXの波形の場合、報告される波形値は元の波形から線形的に減少します。
したがって、-0.5 と +0.5 の間で揺れる波形 (-1 から +1 までのスケール) の場合は、ピークメーターの値を LONG_MAX/2 に設定する必要があります。
ドライバーは、このプロパティ要求を同期的に処理します。 要求が成功すると、ピークメーターがリセットされ、累積ピーク値が 0 に初期化されます。 要求が成功しない場合、ピークメーターは変更されません。
「KSPROPERTY_AUDIO_PEAKMETER2」も参照してください。
例
使用例を次に示します。
// Default peak meter settings
#define PEAKMETER_STEPPING_DELTA 0x1000
#define PEAKMETER_MAXIMUM LONG_MAX
#define PEAKMETER_MINIMUM LONG_MIN
ACX_PEAKMETER_CONFIG peakmeterCfg;
ACX_PEAKMETER_CALLBACKS peakmeterCallbacks;
ACX_PEAKMETER_CALLBACKS_INIT(&peakmeterCallbacks);
peakmeterCallbacks.EvtAcxPeakMeterRetrieveLevel = CodecR_EvtPeakMeterRetrieveLevelCallback;
ACX_PEAKMETER_CONFIG peakmeterCfg;
ACX_PEAKMETER_CONFIG_INIT(&peakmeterCfg);
peakmeterCfg.ChannelsCount = MAX_CHANNELS;
peakmeterCfg.Minimum = PEAKMETER_MINIMUM;
peakmeterCfg.Maximum = PEAKMETER_MAXIMUM;
peakmeterCfg.SteppingDelta = PEAKMETER_STEPPING_DELTA;
peakmeterCfg.Callbacks = &peakmeterCallbacks;
ACX の要件
最小 ACX バージョン: 1.0
ACX バージョンの詳細については、「 ACX バージョンの概要」を参照してください。
要件
| 要件 | 値 |
|---|---|
| Header | acxelements.h |