IAudioClock2

IAudioClock2 インターフェイスは、現在のデバイス位置を取得するために使用します。

GetDevicePosition メソッドは、現在のデバイス位置をフレーム単位でハードウェアから直接取得します。

メソッドが成功した場合は、S_OK を返します。

戻り値のコード	説明
E_POINTER	DevicePosition パラメーターが NULL です。
AUDCLNT_E_DEVICE_INVALIDATED	オーディオ エンドポイントが切断されました。
AUDCLNT_S_POSITION_STALLED	このストリームに対して IAudioClient::Start メソッドが呼び出されていません。

このメソッドは共有モード ストリームにのみ適用されます。

このメソッドは、相関する 2 つのストリーム位置の値を取得します。

• デバイス位置。クライアントは、未処理のデバイス位置を DevicePosition で取得します。これは、現在スピーカーを通じて再生されている(レンダリング ストリームの場合)、またはマイクを通じて録音されている(キャプチャ ストリームの場合)サンプルのストリーム位置です。デバイス エンドポイントのサンプリング レートは、クライアントが使用するミックス形式のサンプリング レートと異なる場合があります。 クライアントからデバイス位置を取得するには、IAudioClock::GetPosition を呼び出します。
• パフォーマンス カウンター。クライアントは、パフォーマンス カウンターを QPCPosition で取得します。GetDevicePosition は、オーディオ エンドポイント デバイスが GetDevicePosition メソッドの DevicePosition パラメーターにストリーム位置を格納した時点で QueryPerformanceCounter 関数を呼び出すことにより、カウンター値を取得します。GetDevicePosition は、カウンター値を 100 ナノ秒時間単位に変換します。QueryPerformanceCounter および QueryPerformanceFrequency の詳細については、Windows SDK のドキュメントを参照してください。

GetDevicePosition 呼び出し時のデバイス位置とパフォーマンス カウンターがあれば、クライアントは後の時点で QueryPerformanceCounter を呼び出して現在のパフォーマンス カウンターを取得し、元のデバイス位置が記録されてからカウンターがどれだけ進んだかに基づいてデバイス位置を補外することで、より新しいデバイス位置の推定値を得ることができます。クライアントは、QueryPerformanceCounter 関数を呼び出して、カウンターをインクリメントするクロックの周波数を取得できます。QueryPerformanceCounter から取得した生のカウンター値を GetDevicePosition で取得した値と比較する前に、次の手順で生のカウンター値を 100 ナノ秒時間単位に変換します。

1. 生のカウンター値に 10,000,000 を乗算します。
2. その結果を QueryPerformanceFrequency から取得したカウンター周波数で除算します。

#define global IID_IAudioClock2 "{6F49FF73-6727-49AC-A008-D98CF5E70048}"
#usecom global IAudioClock2 IID_IAudioClock2 "{}"
#comfunc global IAudioClock2_GetDevicePosition  3 var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。