PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK funzione di callback (wdm.h)

Articolo
02/29/2024

La funzione ClfsAdvanceTailCallback fa avanzare il numero di sequenza del log di base (LSN) del log del client.

Sintassi

PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK PclfsClientAdvanceTailCallback;

NTSTATUS PclfsClientAdvanceTailCallback(
  [in] PLOG_FILE_OBJECT LogFile,
  [in] PCLFS_LSN TargetLsn,
  [in] PVOID ClientData
)
{...}

Parametri

[in] LogFile

Puntatore a una struttura LOG_FILE_OBJECT che rappresenta il flusso di log CLFS la cui parte finale deve essere avanzata.

[in] TargetLsn

Puntatore a una struttura CLFS_LSN che contiene l'LSN che il client deve avanzare verso o oltre la coda.

[in] ClientData

Puntatore alle informazioni fornite dal client. Questi dati vengono specificati nel membro AdvanceTailCallbackData della struttura CLFS_MGMT_CLIENT_REGISTRATION .

Valore restituito

La funzione ClfsAdvanceTailCallback deve restituire STATUS_PENDING o uno stato di errore. Un valore restituito di STATUS_PENDING indica che la richiesta di spostare la parte finale del log del client verrà completata in modo asincrono. La funzione ClfsMgmtAdvanceTailCallback non deve restituire STATUS_SUCCESS, anche se viene completata in modo sincrono.

Commenti

La funzione ClfsAdvanceTailCallback viene chiamata quando la gestione CLFS richiede al client di avanzare la coda del log.

La funzione ClfsAdvanceTailCallback deve eseguire solo una quantità minima di elaborazione prima di restituire . Ad esempio, la funzione ClfsAdvanceTailCallback può seguire questa procedura:

Se la richiesta non può essere elaborata, restituisce uno stato di errore.
Se la richiesta può essere elaborata, creare e accodare un elemento di lavoro per eseguire le azioni necessarie per spostare la coda del client e quindi restituire STATUS_PENDING. Per altre informazioni sull'accodamento di un thread di lavoro, vedere Thread di lavoro di sistema.

Quando un client chiama la routine ClfsMgmtRegisterManagedClient per la registrazione con la gestione CLFS, il client fornisce sia un puntatore alla funzione ClfsAdvanceTailCallback che i dati personalizzati che verranno passati come parametro alla funzione ClfsAdvanceTailCallback 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

CLFS_MGMT_CLIENT_REGISTRATION

ClfsAdvanceLogBase

ClfsMgmtRegisterManagedClient

ClfsMgmtTailAdvanceFailure

Condividi tramite