다음을 통해 공유


IXAudio2::Release 메서드(xaudio2.h)

XAudio2 개체에 대한 참조를 해제합니다.

구문

ULONG Release();

반환 값

항상 0을 반환합니다.

설명

지정된 XAudio2 개체에서 최종 릴리스 를 호출하면 연결된 모든 음성 개체가 제거됩니다. 클라이언트가 여전히 보유하고 있는 이러한 개체에 대한 포인터는 즉시 유효하지 않습니다. 호출을 호출하면 정의되지 않은 동작이 발생합니다. 오디오 처리 엔진도 중지됩니다. 이렇게 하면 릴리스 가 반환된 후 클라이언트는 그래프에서 참조하는 모든 데이터(예: 오디오 원본 버퍼 또는 콜백 처리 개체)를 안전하게 해제할 수 있습니다.

릴리스 는 동기 호출입니다. 결함은 발생하지 않아야 하지만(잠시 처리 잠금만 사용하므로) 타이틀은 XAudio2 콜백에서 이 메서드를 호출하여 잠재적인 스레드 대기 시간을 방지할 수 있습니다.

콜백 내에서 릴리스 를 호출하는 것은 유효하지 않습니다(즉, IXAudio2EngineCallback 또는 IXAudio2VoiceCallback).

플랫폼 요구 사항

Windows 10(XAudio2.9); Windows 8, Windows Phone 8(XAudio 2.8); DirectX SDK(XAudio 2.7)

요구 사항

   
대상 플랫폼 Windows
헤더 xaudio2.h

참고 항목

IXAudio2