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 콜백 개요를 참조하세요.
XAUDIO2 DirectX SDK 버전은 GetState에 대한 Flags 매개 변수를 사용하지 않습니다.
플랫폼 요구 사항
Windows 10(XAudio2.9); Windows 8, Windows Phone 8(XAudio 2.8); DirectX SDK(XAudio 2.7)요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | Windows |
헤더 | xaudio2.h |