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 el cliente llevará a cabo cuando se libere espacio en un registro que anteriormente había estado 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 indique el motivo por el que la solicitud no se pudo completar correctamente.

[in] LogIsPinned

Si es 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

None

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 rutina ClfsMgmtHandleLogFileFull devuelta devuelve STATUS_PENDING, la función ClfsLogGrowthCompleteCallback se invocará cuando se complete la operación. Si se devolvió otro estado, no se invocará la función ClfsLogGrowthCompleteCallback .

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

  1. Si el valor del parámetro OperationStatus es un estado de error, devuelva.
  2. Si el valor del parámetro OperationStatus es STATUS_SUCCESS, cree y poner en cola un elemento de trabajo para informar al cliente de que puede reanudar el procesamiento.
Cuando un cliente usa la rutina ClfsMgmtRegisterManagedClient 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 Value
Cliente mínimo compatible Compatible con Windows Server 2003 R2, Windows Vista y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
IRQL Se llama en IRQL <= APC_LEVEL

Consulte también

ClfsMgmtHandleLogFileFull

ClfsMgmtRegisterManagedClient