> ## 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.

# IXtfDeployCallback 인터페이스 (인터페이스 콘텐츠)

> IXtfDeployCallback 인터페이스

# IXtfDeployCallback 인터페이스

[IXtfApplicationClient::Deploy](/ko/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m) 작업 중에 추적 가능한 동작이 발생할 때 호출되는 콜백을 제공합니다.

## 구문

```cpp theme={null}
interface IXtfDeployCallback : public IUnknown  
```

## 메서드

| 메서드 | 설명 |
| - | - |
| [OnDeployChangeEvaluation](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploychangeevaluation-ixtfdeploycallback-xtfapplication-xb) | 전송하거나 삭제해야 할 파일을 평가할 때 호출되는 콜백입니다. |
| [OnDeployError](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows) | 내부용으로 예약되어 있습니다. |
| [OnDeployExtraFileDetected](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafiledetected-ixtfdeploycallback-xtfapplication-x) | 추가 파일이 감지될 때 호출되는 콜백입니다. |
| [OnDeployExtraFileRemoved](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb) | 콘솔의 추가 파일이 제거되었음을 보고하기 위해 호출되는 콜백입니다. |
| [OnDeployFileProgress](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployfileprogress-ixtfdeploycallback-xtfapplication-xbox-w) | 콘솔로 파일을 배포하는 진행 상황을 보고하기 위해 호출되는 콜백입니다. |
| [OnDeployInitialized](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployinitialized-ixtfdeploycallback-xtfapplication-xbox-wi) | 배포가 시작될 때 호출되는 콜백입니다. |
| [OnDeployMetrics](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window) | 배포 메트릭이 보고될 때 호출되는 콜백입니다. |

## 설명

모든 콜백 메서드는 반환 값과 관련하여 동일한 방식으로 동작합니다. 콜백이 성공한 HRESULT를 반환하면 배포 프로세스가 계속됩니다. 콜백이 실패한 HRESULT를 반환하면 배포 프로세스가 즉시 취소됩니다. 이미 전송되거나 삭제된 파일은 그대로 유지되며, 부분적으로 전송된 파일은 잘린 형태로 닫힙니다.

콜백 프로세스는 간단합니다. 배포 중인 개발 PC의 각 파일이 대상 콘솔의 해당 파일과 비교됩니다.

* 파일이 PC와 콘솔에서 동일하면 더 이상 아무 작업도 수행되지 않습니다.
* PC의 파일이 콘솔의 파일보다 최신이면 파일이 PC에서 콘솔로 복사됩니다.
* 파일이 PC에는 있지만 콘솔에는 없으면 콘솔로 복사됩니다.
* 파일이 콘솔에는 있지만 PC에는 없으면 선택적으로 콘솔에서 삭제됩니다. (삭제 여부는 [Deploy](/ko/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m)의 fRemoveExtraFiles 매개 변수 값에 의해 결정됩니다).

콜백 메서드는 배포 프로세스 중 적절한 시점에 호출됩니다.

1. [OnDeployInitialized](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployinitialized-ixtfdeploycallback-xtfapplication-xbox-wi): 이 콜백은 배포 시스템이 활성화되었을 때 호출되며 배포 시간 측정을 시작하거나 진행률 대화 상자를 초기화하는 데 사용할 수 있습니다. 이 콜백이 호출된 시점에는 모든 잠재적인 상호 운용성 및 DLL 경계 교차가 성공적으로 완료된 상태입니다. 이 콜백은 배포당 한 번 호출됩니다.
2. [OnDeployChangeEvaluation](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploychangeevaluation-ixtfdeploycallback-xtfapplication-xb): 이 콜백은 배포 시스템이 콘솔에 배포하거나 콘솔에서 삭제해야 하는 파일을 평가할 때 호출됩니다. 이 콜백을 사용하여 진행률 표시기를 업데이트할 수 있습니다.
3. [OnDeployMetrics](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window): 이 콜백은 평가 프로세스가 끝날 때 한 번 호출되며, 콘솔로 배포될 파일 수와 전송될 총 바이트 수를 보고합니다.
4. [OnDeployFileProgress](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployfileprogress-ixtfdeploycallback-xtfapplication-xbox-w): 이 콜백은 파일별로 버퍼 블록이 성공적으로 전송될 때마다 호출됩니다. 전송은 여러 스레드에서 동시에 수행되므로 코드에서 파일 이름별로 진행 상황을 추적하고 일반적인 다중 스레딩 문제로부터 보호해야 합니다. 이 콜백은 전송 시작 시 한 번, 전송 종료 시 한 번 호출되므로 길이가 0인 파일의 경우 이 콜백이 두 번 호출됩니다.
5. [OnDeployExtraFileDetected](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafiledetected-ixtfdeploycallback-xtfapplication-x): PC에는 없고 콘솔에서 발견된 파일이 있음을 나타냅니다.
6. [OnDeployExtraFileRemoved](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb): [Deploy](/ko/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m)의 fRemoveExtraFiles 매개 변수가 TRUE로 설정된 경우, 콘솔에서 파일이 삭제될 때 이 콜백이 호출됩니다.
7. [OnDeployError](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows)는 현재 구현에서는 사용되지 않지만 향후 사용을 위해 예약되어 있습니다.

전체 배포 진행률을 표시하려면 코드에서 OnDeployMetrics 콜백에 보고된 총 파일 수 대비 지금까지 OnDeployFileProgress 콜백에서 명명된 서로 다른 파일 수를 백분율로 보고해야 합니다.

## 요구 사항

**헤더:** xtfapplication.h

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

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

## 함께 보기

##### 참조

[XtfApplication](/ko/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [IXtfRemoteRunCallback 인터페이스 (인터페이스 콘텐츠)](/ko/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)
- [IXtfConfigSettingsCallback (인터페이스 콘텐츠)](/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback.md)
- [IXtfRunningProcessCallback (인터페이스 콘텐츠)](/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [IXtfConsoleControlClient (인터페이스 콘텐츠)](/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
- [IGameInput (인터페이스 콘텐츠)](/ko/reference/input/gameinput/interfaces/igameinput/igameinput.md)