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

# XtfGetTitleOSState

> XtfGetTitleOSState

# XtfGetTitleOSState

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

<a id="syntaxSection" />

## 구문

```cpp theme={null}
HRESULT XtfGetTitleOSState(
        PCWSTR address,
        UINT32* titleStateFlags,
        UINT32* pid,
        PWSTR packageFullName,
        UINT32* packageFullNameLength,
        PWSTR aumid,
        UINT32* aumidLength)
```

<a id="parametersSection" />

### 매개 변수

*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)](/tools/tools-console/commandlinetools/xbapp) 및 [Managing applications and files (NDA topic)](/tools/tools-console/xbom/manager-tool-managing-applications)를 참조하세요. |
| 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`로 설정하세요.

<a id="retvalSection" />

### 반환값

형식: HRESULT

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

<a id="remarksSection" />

## 설명

이 함수는 현재 실행 중인 게임의 상태에 관한 정보를 반환합니다. 여기에는 타이틀 상태 플래그, 프로세스 ID, 패키지 전체 이름, AUMID(Application User Model ID)가 포함됩니다. 패키징에 대한 자세한 내용은 [Packaging](/build/core-features/common/packaging/gc-packaging-toc)을 참조하세요.

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

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

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

<a id="requirementsSection" />

## 요구 사항

**헤더:** xtfapi.h

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

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

<a id="seealsoSection" />

## 참고 항목

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


## Related topics

- [XtfGetCachedTitleOSVersions](/ko/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md)
- [XtfGetTitleOSFourPartVersion](/ko/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m.md)
- [XtfGetTitleProcessMemoryReports](/ko/reference/tools/xtf/xtfapi/functions/xtfgettitleprocessmemoryreports-xtfapi-xbox-windows-m.md)
- [XtfGetCachedTitleOSVersionsCallback](/ko/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversionscallback-xtfapi-xbox-windows-m.md)
- [XtfStartTitleOS](/ko/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m.md)