PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK funzione di callback (wdm.h)

Articolo
02/27/2024

La funzione ClfsLogGrowthCompleteCallback implementa le azioni che verranno eseguite dal client quando lo spazio viene liberato in un log precedentemente pieno.

Sintassi

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 che il client eseguirà quando la condizione completa del file di log è stata gestita appartiene alla funzione ClfsLogGrowthCompleteCallback .

Se viene restituita una chiamata alla routine ClfsMgmtHandleLogFileFull 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 di restituire . Ad esempio, la funzione ClfsLogGrowthCompleteCallback può seguire la procedura seguente:

Se il valore del parametro OperationStatus è uno stato di errore, restituire.
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 ClfsMgmtRegisterManagedClient per la registrazione con la gestione CLFS, il client fornisce sia un puntatore alla funzione ClfsLogGrowthCompleteCallback che i dati personalizzati che verranno passati come parametro alla funzione ClfsLogGrowthCompleteCallback quando questa funzione viene chiamata.

Requisiti

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

Vedi anche

ClfsMgmtHandleLogFileFull

ClfsMgmtRegisterManagedClient

Condividi tramite