XClosedCaptionGetProperties

아티클
05/10/2023

현재 선택 자막의 속성을 반환합니다.

구문

HRESULT XClosedCaptionGetProperties(  
         XClosedCaptionProperties* properties  
)

매개 변수

속성 _Out_
형식: XClosedCaptionProperties*

함수가 반환되면 속성에 현재 선택 자막 속성이 포함됩니다.

반환 값

형식: HRESULT

선택 자막이 활성화되어 있고 속성에 현재 XClosedCaptionProperties가 포함되어 있는 경우 HRESULT를 반환합니다. 그렇지 않으면 오류 코드를 반환합니다.
오류 코드 목록은 오류 코드를 참조하세요.

설명

참고 항목

이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.

이 함수를 성공적으로 수행하려면 선택 자막을 사용하도록 설정해야 합니다. 사용자는 게임 타이틀의 UI에서 선택 자막 기능을 사용하도록 설정해야 합니다. 사용자가 선택 자막을 사용하도록 설정한 경우 게임 타이틀은 XClosedCaptionSetEnabled를 호출하여 선택 자막의 상태에 플래그를 지정할 수 있습니다.

다음 예제에서는 선택 자막 속성을 반환하는 방법을 보여줍니다.

XClosedCaptionProperties ccProperties;
if (SUCCEEDED(XClosedCaptionGetProperties(&ccProperties))
{
    // The game title can now access color and font settings in the ccProperties structure.
}