다음을 통해 공유


IXtfConsoleControlClient::GetConfigSettings

모든 구성 설정을 열거하여 각 구성 설정에 대해 콜백을 호출합니다.

구문

HRESULT GetConfigSettings(
         IXtfConfigSettingsCallback *pCallback
)  

매개 변수

pCallback
형식: IXtfConfigSettingsCallback*

각 구성 설정이 열거될 때 호출되는 IXtfConfigSettingsCallback의 인스턴스에 대한 포인터입니다.

반환 값

형식: HRESULT

성공한 경우 S_OK을(를) 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 기능을 사용하면 XTF(Xbox 도구 프레임워크) API에서 현재 개발 콘솔의 모든 구성 설정을 열거할 수 있습니다. 구성 설정을 찾은 경우 XTF API는 해당 앱에서 구현되고 pCallback에서 지정된 IXtfConfigSettingsCallback 인터페이스로부터 OnFoundSetting 콜백 함수를 호출합니다. XTF API는 XTFCONFIGSETTING 구조체에 포인터를 전달하여 구현된 OnFoundSetting 함수를 호출하는 경우 구성 설정을 설명합니다.

참고 항목

XTFCONFIGSETTING 구조체의 메모리는 XTF(Xbox 도구 프레임워크) API에서 소유하고 있으며, IXtfConfigSettingsCallback::OnFoundSetting 콜백 함수를 호출한 후 무효화됩니다. 나중에 사용하기 위해 필요한 경우 구조체에서 해당 정보를 복사해야 합니다.

IXtfConsoleControlClient:: GetAllSettings 메서드를 사용하여 현재 개발 콘솔에서 모든 구성 설정에 대한 XTFCONFIGSETTING 구조체 배열을 반환할 수도 있습니다.

XTF(Xbox 도구 프레임워크)를 사용하여 구성 설정에 액세스하는 방법에 대한 자세한 내용은 구성(xbconfig.exe)(NDA 항목)권한 부여 필요을 참조하세요.

요구 사항

헤더: xtfconsolecontrol.h

라이브러리: xtfconsolecontrol.lib

지원되는 플랫폼: Windows(Xbox 콘솔 도구용)

참고 항목

IXtfConfigSettingsCallback::OnFoundSetting
IXtfConsoleControlClient::GetAllSettings
IXtfConsoleControlClient
XtfConsoleControl