IXAudio2SourceVoice::GetState メソッド (xaudio2.h)
音声の現在のカーソル位置データを返します。
構文
void GetState(
XAUDIO2_VOICE_STATE *pVoiceState,
[optional] UINT32 Flags
);
パラメーター
pVoiceState
音声の状態を含む XAUDIO2_VOICE_STATE 構造体へのポインター。
[optional] Flags
返される音声状態データを制御するフラグ。 有効な値は 0 または XAUDIO2_VOICE_NOSAMPLESPLAYEDです。 既定値は 0 です。 XAUDIO2_VOICE_NOSAMPLESPLAYEDを指定した場合、GetState はサンプラー状態ではなくバッファー状態のみを返します。 GetState は、XAUDIO2_VOICE_NOSAMPLESPLAYEDを指定すると、完了までに約 3 分 の 1 の時間がかかります。
戻り値
なし
解説
クライアントが複数の音声の相関位置を取得する必要がある場合 (たとえば、別の音声の特定のサンプルが再生されているときに、特定の音声のどのサンプルが再生されているかを正確に把握するために)、XAudio2 エンジン コールバックで GetState 呼び出しを行う必要があります。 これにより、通話中にどの音声も進めないようにします。 XAudio2 コールバックの使用については、XAudio2 コールバックの概要に関するページを参照してください。
DirectX SDK バージョンのXAUDIO2は 、GetState の Flags パラメーターを受け取りません。
プラットフォームの要件
Windows 10 (XAudio2.9);Windows 8、Windows Phone 8 (XAudio 2.8);DirectX SDK (XAudio 2.7)要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | xaudio2.h |