IXtfDeployCallback::OnDeployFileProgress
本体へのファイル展開の進行状況を報告するために呼び出されるコールバック。
構文
public:
HRESULT OnDeployFileProgress(
LPCWSTR pszFilePath,
ULONGLONG ullBytesTransferred,
ULONGLONG ullFileSize
)
パラメーター
pszFilePath
型: LPCWSTR
展開されているファイルのパス。
ullBytesTransferred
型: ULONGLONG
その時点までにインストールされたバイト数。
ullFileSize
型: ULONGLONG
転送されているファイル全体のサイズ (バイト単位)。
戻り値
型: HRESULT
S_OK を返すと配置が続行され、HRESULT エラー コードを返すと配置が取り消されます。
解説
このコールバックは、配置システムが配置 中のPC からコンソールにファイルを転送するときに呼び出されます。 このコールバックは、ファイルに正常に転送された各バッファー ブロックごとに 1 回呼び出されます。 このコールバックは、ファイルが正常に転送されるたびに、常に少なくとも 2 回呼び出されます。1 回は配置の開始時、もう 1 回は配置の終了時です。 ゼロ長のファイルが配置されている場合、両方の呼び出しで、 0 バイトの内 0 バイトが転送されたことが報告されます。 ファイルの評価方法、および配置プロセス中にコールバックが呼び出されるタイミングの詳細については、「IXtfDeployCallback インターフェイス」を参照してください。
注意
配置用のファイル転送プロセスは、複数のスレッドを使用します。 コードは、pszFilePath による進行状況メッセージを相互に関連付け、一般的なマルチスレッドの問題から保護することを保証する必要があります。
IXtfDeployCallback の他のコールバックと同様に、このコールバックによって S_OK が返されると、配置プロセスは続行されます。 このコールバックによって HRESULT エラー コードが返された場合、配置プロセスはすぐに取り消されます。 既に転送または削除されているファイルはそのままになり、部分的に転送されたファイルは、切り捨てられた形で閉じられます。 本体上のすべてのファイルが完全で最新の状態であることを確認するには、もう 1 回配置を完了する必要があります。
要件
ヘッダー: xtfapplication.h
ライブラリ: xtfapplication.lib
サポートされているプラットフォーム: Windows (Xbox 本体ツール用)