Funzione ClfsReadRestartArea (wdm.h)
La routine ClfsReadRestartArea legge il record di riavvio scritto più di recente in un flusso CLFS specificato.
Sintassi
CLFSUSER_API NTSTATUS ClfsReadRestartArea(
[in, out] PVOID pvMarshalContext,
[out] PVOID *ppvRestartBuffer,
[out] PULONG pcbRestartBuffer,
[out] PCLFS_LSN plsn,
[out] PVOID *ppvReadContext
);
Parametri
[in, out] pvMarshalContext
Puntatore a un contesto opaco che rappresenta un'area di marshalling associata a un flusso CLFS. Il chiamante ottenuto in precedenza questo puntatore chiamando ClfsCreateMarshallingArea.
[out] ppvRestartBuffer
Puntatore a una variabile che riceve un puntatore al buffer di dati del record di riavvio.
[out] pcbRestartBuffer
Puntatore a una variabile tipizzata ULONG che riceve le dimensioni, in byte, del buffer di dati a cui punta pcbRestartBuffer. Si tratta della lunghezza del buffer di dati del record di riavvio.
[out] plsn
Puntatore a una struttura CLFS_LSN che riceve l'LSN del record di riavvio letto.
[out] ppvReadContext
Puntatore a una variabile che riceve un puntatore a un contesto di lettura opaco. Il chiamante può passare questo contesto a ClfsReadPreviousRestartArea o ClfsReadNextLogRecord. Al termine dell'utilizzo del contesto di lettura, il chiamante deve liberare il contesto chiamando ClfsTerminateReadLog.
Valore restituito
clfsReadRestartArea restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.
Osservazioni
Per una spiegazione dei concetti e della terminologia di CLFS, vedere Common Log File System.
Per informazioni sulla lettura di record da flussi CLFS, vedere Lettura di record di dati da un flusso CLFS e lettura dei record di riavvio da un flusso CLFS.
I contesti di lettura non sono thread-safe. I client sono responsabili della serializzazione dell'accesso ai contesti di lettura.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows Server 2003 R2, Windows Vista e versioni successive di Windows. |
| piattaforma di destinazione | Desktop |
| intestazione | wdm.h (include Wdm.h) |
| libreria | Clfs.lib |
| dll | Clfs.sys |
| IRQL | <= APC_LEVEL |