Compartir a través de

PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK función de devolución de llamada (wdm.h)

  • Artículo

La función ClfsLogGrowthCompleteCallback implementa las acciones que llevará a cabo el cliente cuando se libere espacio en un registro que anteriormente se había lleno.

Sintaxis

PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK PclfsClientLffHandlerCompleteCallback;

void PclfsClientLffHandlerCompleteCallback(
  [in] PLOG_FILE_OBJECT LogFile,
  [in] NTSTATUS OperationStatus,
  [in] BOOLEAN LogIsPinned,
  [in] PVOID ClientData
)
{...}

Parámetros

[in] LogFile

Puntero a una estructura de LOG_FILE_OBJECT que representa el flujo de registro clFS cuyo registro ha terminado de crecer.

[in] OperationStatus

Estado de la solicitud anterior del cliente para controlar una condición completa del archivo de registro. Esto será STATUS_SUCCESS o un estado de error que indica el motivo por el que la solicitud no se pudo completar correctamente.

[in] LogIsPinned

Si TRUE, especifica que la cola del registro está anclada actualmente; FALSE si el final del registro no está anclado.

[in] ClientData

Puntero a la información proporcionada por el cliente.

Valor devuelto

Ninguno

Observaciones

Dado que una llamada a ClfsMgmtHandleLogFileFull se completa de forma asincrónica, las acciones que realizará el cliente cuando se haya controlado la condición completa del archivo de registro pertenecen a la función ClfsLogGrowthCompleteCallback.

Si una llamada a la ClfsMgmtHandleLogFileFull rutina devuelta devuelve STATUS_PENDING, se invocará la función ClfsLogGrowthCompleteCallback cuando se complete la operación. Si se devolvió un estado diferente, no se invocará la función ClfsLogGrowthCompleteCallback.

La función ClfsLogGrowthCompleteCallback solo debe realizar una cantidad mínima de procesamiento antes de devolver. Por ejemplo, la función ClfsLogGrowthCompleteCallback podría seguir el procedimiento siguiente:

  1. Si el valor de parámetro OperationStatus es un estado de error, devuelve.
  2. Si el valor del parámetro OperationStatus es STATUS_SUCCESS, cree y pone en cola un elemento de trabajo para informar al cliente de que puede reanudar el procesamiento.
Cuando un cliente usa la rutina clfsMgmtRegisterRegisterManagedClient para registrarse con la administración de CLFS, el cliente proporciona un puntero a la función ClfsLogGrowthCompleteCallback y los datos personalizados que se pasarán como parámetro a la función clfsLogGrowthCompleteCallback cuando se llame a esta función.

Requisitos

Requisito Valor
cliente mínimo admitido Compatible con Windows Server 2003 R2, Windows Vista y versiones posteriores de Windows.
de la plataforma de destino de Escritorio
encabezado de wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
irQL Llamado en IRQL <= APC_LEVEL

Consulte también

ClfsMgmtHandleLogFileFull

ClfsMgmtRegisterManagedClient