> ## 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::OnDeployMetrics 方法

> IXtfDeployCallback::OnDeployMetrics 方法

# IXtfDeployCallback::OnDeployMetrics 方法

回報部署計量時叫用的回呼。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
public:
HRESULT OnDeployMetrics(
         ULONGLONG ullTotalFiles,
         ULONGLONG ullTotalBytes
)  
```

<a id="parametersSection" />

### 參數

*ullTotalFiles*\
類型：ULONGLONG

將部署的檔案數目。

*ullTotalBytes*\
類型：ULONGLONG

部署期間將傳輸的位元組數目。

<a id="retvalSection" />

### 傳回值

類型：HRESULT

傳回 `S_OK` 以繼續部署，或傳回 HRESULT 錯誤碼以取消部署。

<a id="remarksSection" />

## 備註

此回呼會在部署系統評估哪些檔案需要部署至主機或從開發主機刪除之後叫用一次，以回報部署期間預期要部署的檔案總數以及要傳輸的位元組總數。如需在部署程序期間如何評估檔案以及何時叫用回呼的詳細資訊，請參閱 [IXtfDeployCallback 介面](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t)。

與 `IXtfDeployCallback` 的其他回呼相同，如果此回呼傳回 `S_OK`，部署程序就會繼續。如果此回呼傳回任何 `HRESULT` 錯誤碼，部署程序就會立即取消。已傳輸或已刪除的檔案會維持原狀，而部分傳輸的檔案則會以截斷的形式關閉。必須再完成一次部署，才能確保主機上的所有檔案都完整且為最新狀態。

<a id="requirementsSection" />

## 需求

**標頭：** xtfapplication.h

**程式庫：** xtfapplication.lib

**支援的平台：** Windows (適用於 XBOX 主機工具)

<a id="seealsoSection" />

## 另請參閱

[IXtfDeployCallback 介面](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t)\
[XtfApplication](/zh-TW/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [IXtfDeployCallback::OnDeployInitialized 方法](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployinitialized-ixtfdeploycallback-xtfapplication-xbox-wi.md)
- [IXtfDeployCallback::OnDeployExtraFileRemoved](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb.md)
- [IXtfDeployCallback::OnDeployError](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows.md)
- [IXtfDeployCallback::OnDeployFileProgress](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployfileprogress-ixtfdeploycallback-xtfapplication-xbox-w.md)
- [IXtfDeployCallback::OnDeployChangeEvaluation](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploychangeevaluation-ixtfdeploycallback-xtfapplication-xb.md)