> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XtfGetTitleOSState

> XtfGetTitleOSState

# XtfGetTitleOSState

실행 중인 게임에 대한 정보(상태, 프로세스 ID, 패키지 전체 이름, AUMID(Application User Model ID) 포함)를 가져옵니다.

## 구문

```cpp theme={null}
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 | 이 게임에 대해 Fast Iteration Mode가 활성화되어 있습니다. Fast Iteration Mode에 대한 자세한 내용은 [Application Management (xbapp.exe) (NDA topic)](https://docs.xbox.com/ko/tools/tools-console/commandlinetools/xbapp.md) 및 [Managing applications and files (NDA topic)](https://docs.xbox.com/ko/tools/tools-console/xbom/manager-tool-managing-applications.md)를 참조하세요. |
| XTF\_TITLESTATE\_TITLE\_RUNNING | 0x0002 | 게임이 현재 실행 중입니다. |
| XTF\_TITLESTATE\_TITLEOS\_RUNNING | 0x0004 | 게임의 Game OS가 현재 실행 중입니다. |
| XTF\_TITLESTATE\_TITLENETWORK\_READY | 0x0008 | 게임에 대해 네트워킹 준비가 되었습니다. |

*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](https://docs.xbox.com/ko/build/core-features/common/packaging/gc-packaging-toc.md)을 참조하세요.

`packageFullName` 및 `aumid` 버퍼에 필요한 버퍼 길이를 검색하려면 다음 단계를 수행하세요:

1. `packageFullName` 및 `aumid` 매개 변수를 `nullptr`로 설정합니다.
2. `packageFullNameLength` 및 `aumidLength` 매개 변수를 유효한 UINT32 포인터로 설정합니다.
3. `XtfGetTitleOSState`를 호출합니다.

함수가 성공적으로 실행되면 `packageFullNameLength` 및 `aumidLength` 매개 변수에 각각 `packageFullName` 및 `aumidLength`에 필요한 버퍼 길이(WCHAR 단위)가 들어갑니다.

## 요구 사항

**헤더:** xtfapi.h

**라이브러리:** XtfApi.lib

**지원 플랫폼:** Windows(XBOX 콘솔 도구용)

## 참고 항목

[XtfGetAumid](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfgetaumid-xtfapi-xbox-windows-m.md)\
[XtfGetPackageFullName](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m.md)\
[XTF Transport Errors (NDA topic)](https://docs.xbox.com/ko/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[Additional Xtf APIs](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [추가 Xtf API (API 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [XtfGetCachedTitleOSVersions](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md)
- [XtfGetTitleOSFourPartVersion](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m.md)
- [XtfGetTitleProcessMemoryReports](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfgettitleprocessmemoryreports-xtfapi-xbox-windows-m.md)
- [XtfGetCachedTitleOSVersionsCallback](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversionscallback-xtfapi-xbox-windows-m.md)