XtfGetTitleOSState
실행 중인 게임에 대한 정보(상태, 프로세스 ID, 패키지 전체 이름, AUMID(Application User Model ID) 포함)를 가져옵니다.구문
매개 변수
address형식: PCWSTR [in] 콘솔의 주소입니다. titleStateFlags
형식: UINT32* [out, optional] 게임에 관한 추가 정보를 제공하는 플래그의 비트별 OR 조합입니다. 이 값이 필요하지 않으면
nullptr로 설정하세요. 이 매개 변수는 다음 플래그를 지원합니다:
pid
형식: UINT32* [out, optional] 게임이 현재 실행 중인 경우 게임의 프로세스 ID이고, 그렇지 않으면 0입니다. 이 값이 필요하지 않으면
nullptr로 설정하세요.
packageFullName형식: PWSTR [out, optional] 게임이 현재 실행 중인 경우 게임의 패키지 전체 이름이고, 그렇지 않으면 빈 문자열("")입니다. 이 값이 필요하지 않거나 버퍼 길이만 필요한 경우
nullptr로 설정하세요.
packageFullNameLength형식: UINT32* [out, optional] packageFullName에 필요한 버퍼의 길이(WCHAR 단위)입니다. 이 값이 필요하지 않으면
nullptr로 설정하세요.
aumid형식: PWSTR [out, optional] 게임이 현재 실행 중인 경우 게임의 AUMID이고, 그렇지 않으면 빈 문자열("")입니다. 이 값이 필요하지 않으면
nullptr로 설정하세요.
aumidLength형식: UINT32* [out, optional] aumid에 필요한 버퍼의 길이(WCHAR 단위)입니다. 이 값이 필요하지 않으면
nullptr로 설정하세요.
반환값
형식: HRESULT 성공하면S_OK를 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다. packageFullName 또는 aumid 버퍼가 너무 작으면 HRESULT_FROM_WIN32(ERROR_MORE_DATA)를 반환합니다.
설명
이 함수는 현재 실행 중인 게임의 상태에 관한 정보를 반환합니다. 여기에는 타이틀 상태 플래그, 프로세스 ID, 패키지 전체 이름, AUMID(Application User Model ID)가 포함됩니다. 패키징에 대한 자세한 내용은 Packaging을 참조하세요.packageFullName 및 aumid 버퍼에 필요한 버퍼 길이를 검색하려면 다음 단계를 수행하세요:
packageFullName및aumid매개 변수를nullptr로 설정합니다.packageFullNameLength및aumidLength매개 변수를 유효한 UINT32 포인터로 설정합니다.XtfGetTitleOSState를 호출합니다.
packageFullNameLength 및 aumidLength 매개 변수에 각각 packageFullName 및 aumidLength에 필요한 버퍼 길이(WCHAR 단위)가 들어갑니다.
요구 사항
헤더: xtfapi.h 라이브러리: XtfApi.lib 지원 플랫폼: Windows(XBOX 콘솔 도구용)참고 항목
XtfGetAumidXtfGetPackageFullName
XTF Transport Errors (NDA topic)
Additional Xtf APIs