IXtfDeployCallback::OnDeployFileProgress
Devolución de llamada que se invoca para notificar el progreso de la implementación de un archivo en la consola.Sintaxis
Parámetros
pszFilePathTipo: LPCWSTR Ruta de acceso del archivo que se está implementando. ullBytesTransferred
Tipo: ULONGLONG Número de bytes transferidos hasta el momento. ullFileSize
Tipo: ULONGLONG Tamaño total del archivo que se está transfiriendo, en bytes.
Valor devuelto
Tipo: HRESULT DevuelveS_OK para continuar con la implementación, o un código de error HRESULT para cancelar la implementación.
Comentarios
Esta devolución de llamada se invoca cuando el sistema de implementación transfiere archivos desde el equipo que realiza la implementación a la consola. Esta devolución de llamada se llama una vez por cada bloque de búfer que se transfiere correctamente para un archivo. Esta devolución de llamada siempre se invoca al menos dos veces por cada archivo transferido correctamente: una vez al principio de la implementación y otra al final de la implementación. Si se implementa un archivo de longitud cero, ambas invocaciones notifican que se han transferido cero bytes de cero bytes. Para obtener más información sobre cómo se evalúan los archivos y cuándo se invocan las devoluciones de llamada durante el proceso de implementación, consulte Interfaz IXtfDeployCallback.El proceso de transferencia de archivos para la implementación usa varios subprocesos. El código debe asegurarse de que correlaciona los mensajes de progreso mediante
pszFilePath y de que se protege frente a los problemas habituales de multithreading.IXtfDeployCallback, el proceso de implementación continúa si esta devolución de llamada devuelve S_OK. Si esta devolución de llamada devuelve cualquier código de error HRESULT, el proceso de implementación se cancela inmediatamente. Los archivos que ya se han transferido o eliminado permanecen tal como están, y los archivos transferidos parcialmente se cierran en su forma truncada. Debe completarse otra implementación para garantizar que todos los archivos de la consola estén completos y actualizados.
Requisitos
Encabezado: xtfapplication.h Biblioteca: xtfapplication.lib Plataformas compatibles: Windows (para las herramientas de consola XBOX)Consulte también
Interfaz IXtfDeployCallbackXtfApplication