다음을 통해 공유

XtfGetTitleOSState

  • 아티클

진행 중인 게임에 대한 정보(상태, 프로세스 ID, 패키지 전체 이름, 응용 프로그램 사용자 모델 ID (AUMID) 포함)를 가져옵니다.

구문

HRESULT XtfGetTitleOSState(
        PCWSTR address,
        UINT32* titleStateFlags,
        UINT32* pid,
        PWSTR packageFullName,
        UINT32* packageFullNameLength,
        PWSTR aumid,
        UINT32* aumidLength)

매개 변수

address
형식: PCWSTR

[in] 콘솔의 주소입니다.

titleStateFlags
형식: UINT32*

[out, optional] 게임에 대한 추가 정보를 제공하는 플래그의 비트 OR 조합입니다. 이 값이 필요 하지 않은 경우 nullptr으로 설정합니다. 이 매개 변수는 다음 플래그를 지원합니다.

플래그 값 설명
XTF_TITLESTATE_FASTITERATION_ENABLED 0x0001 이 게임에서 고속 반복 모드를 사용할 수 있습니다. 고속 반복 모드에 관한 자세한 내용은 애플리케이션 관리(xbapp.exe)(NDA 항목) 및 애플리케이션 및 파일 관리(NDA 항목)를 참조하세요.
XTF_TITLESTATE_TITLE_RUNNING 0x0002 게임이 현재 실행 중입니다.
XTF_TITLESTATE_TITLEOS_RUNNING 0x0004 현재 게임 OS가 실행 중입니다.
XTF_TITLESTATE_TITLENETWORK_READY 0x0008 게임에 대한 네트워킹이 준비되었습니다.

pid
형식: UINT32*

[out, optional] 게임이 현재 실행 중인 경우 게임의 프로세스 ID입니다. 그렇지 않으면 0입니다. 이 값이 필요하지 않은 경우 nullptr(으)로 설정합니다.

packageFullName
형식: PWSTR

[out, optional] 게임이 현재 실행 중인 경우 게임의 패키지 전체 이름입니다. 그렇지 않으면 빈 문자열("")입니다. 이 값이 필요하지 않거나 버퍼 길이가 필요한 경우 nullptr으로 설정합니다.

packageFullNameLength
형식: UINT32*

[out, optional] WCHAR의 packageFullName 에 필요한 버퍼의 길이입니다. 이 값이 필요하지 않은 경우 nullptr(으)로 설정합니다.

aumid
형식: PWSTR

[out, optional] 게임이 현재 실행 중인 경우 게임의 AUMID입니다. 그렇지 않으면 빈 문자열("")입니다. 이 값이 필요하지 않은 경우 nullptr(으)로 설정합니다.

aumidLength
형식: UINT32*

[out, optional] WCHAR에서 aumid 에 필요한 버퍼의 길이입니다. 이 값이 필요하지 않은 경우 nullptr(으)로 설정합니다.

반환 값

형식: HRESULT

성공한 경우 S_OK(을)를 반환하고, 그렇지 않으면 HRESULT 오류 코드를 반환합니다. packageFullName 또는 aumid 버퍼가 너무 작으면 HRESULT_FROM_WIN32(ERROR_MORE_DATA)를 반환합니다.

주석

이 함수는 현재 실행 중인 게임의 상태에 대한 정보를 반환합니다. 타이틀 상태 플래그, 프로세스 ID, 패키지 전체 이름, 응용 프로그램 사용자 모델 ID(AUMID) 등을 말합니다. 자세한 내용은 패키징을 참조하세요.

packageFullName와 aumid 버퍼에 필요한 버퍼 길이를 검색하려면 다음 단계를 시행해야 합니다.

  1. packageFullName 및 aumid 매개 변수를 nullptr(으)로 설정
  2. packageFullNameLength와 aumidLength 매개 변수를 유효한 UINT32 포인터로 설정
  3. XtfGetTitleOSState 호출

함수가 성공적으로 실행되면 packageFullNameLength와 aumidLength 매개 변수에 각각 packageFullName와 aumidLength에 대한 필수 버퍼 길이 (WCHAR)가 들어 있습니다.

요구 사항

헤더: xtfapi.h

라이브러리: XtfApi.lib

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

참고 항목

XtfGetAumid
XtfGetPackageFullName
XTF 전송 오류(NDA 항목)
추가 Xtf API