PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK funzione di callback (wdm.h)

Articolo
07.02.2025

La funzione ClfsLogGrowthCompleteCallback implementa le azioni che il client eseguirà quando lo spazio viene liberato in un log precedentemente pieno.

Sintassi

C++

PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK PclfsClientLffHandlerCompleteCallback;

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

Parametri

[in] LogFile

Puntatore a una struttura LOG_FILE_OBJECT che rappresenta il flusso di log CLFS il cui log è terminato di crescere.

[in] OperationStatus

Stato della richiesta precedente del client per gestire una condizione completa del file di log. Si tratta di STATUS_SUCCESS o di uno stato di errore che indica il motivo per cui la richiesta non è stata completata correttamente.

[in] LogIsPinned

Se TRUE, specifica che la parte finale del log è attualmente bloccata; FALSE se la parte finale del log non è bloccata.

[in] ClientData

Puntatore alle informazioni fornite dal client.

Valore restituito

Nessuno

Osservazioni

Poiché una chiamata a ClfsMgmtHandleLogFileFull viene completata in modo asincrono, tutte le azioni eseguite dal client quando la condizione completa del file di log è stata gestita appartiene alla funzione ClfsLogGrowthCompleteCallback.

Se una chiamata alla routine ClfsMgmtHandleLogFull restituita restituisce STATUS_PENDING, la funzione ClfsLogGrowthCompleteCallback verrà richiamata al termine dell'operazione. Se è stato restituito uno stato diverso, la funzione ClfsLogGrowthCompleteCallback non verrà richiamata.

La funzione ClfsLogGrowthCompleteCallback deve eseguire solo una quantità minima di elaborazione prima della restituzione. Ad esempio, la funzione ClfsLogGrowthCompleteCallback potrebbe seguire la procedura seguente:

Se il valore del parametro OperationStatus è uno stato di errore, restituisce .
Se il valore del parametro OperationStatus è STATUS_SUCCESS, creare e accodare un elemento di lavoro per informare il client che può riprendere l'elaborazione.

Quando un client usa la routine di ClfsMgmtRegisterManagedClient per la registrazione con la gestione CLFS, il client fornisce sia un puntatore alla funzione ClfsLogGrowthCompleteCallback che verranno passati come parametro al ClfsLogGrowthCompleteCallback quando questa funzione viene chiamata.

Fabbisogno

Requisito	Valore
client minimo supportato	Supportato in Windows Server 2003 R2, Windows Vista e versioni successive di Windows.
piattaforma di destinazione	Desktop
intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL	Chiamato in IRQL <= APC_LEVEL

Vedere anche

ClfsMgmtHandleLogFileFull

ClfsMgmtRegisterManagedClient

Condividi tramite