Метод 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 возвращает только состояние буфера, а не состояние выборки. При указании XAUDIO2_VOICE_NOSAMPLESPLAYED getState требуется примерно одна треть времени.

Возвращаемое значение

None

Remarks

Если клиенту необходимо получить коррелированные позиции нескольких голосов (например, чтобы точно знать, какой образец данного голоса воспроизводит при воспроизведении определенной выборки другого голоса), он должен выполнять вызовы GetState в подсистеме XAudio2. Это гарантирует, что ни один из голосов не будет продвигаться во время звонков. Сведения об использовании обратных вызовов XAudio2 см. в обзоре обратных вызовов XAudio2.

Обратите внимание, что версии пакета SDK для DirectX XAUDIO2 не принимают параметр Flags для GetState.

Требования к платформе

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); Пакет SDK Для DirectX (XAudio 2.7)

Требования

Требование Значение
Целевая платформа Windows
Header xaudio2.h

См. также раздел

Руководство: организация звукового потока с диска

IXAudio2SourceVoice