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