Funzione ZwFlushBuffersFileEx (ntifs.h)
La routine ZwFlushBuffersFileEx viene chiamata da un driver di filtro del file system per inviare una richiesta di scaricamento per un determinato file al file system. È possibile impostare un flag di operazione di scaricamento facoltativo per controllare la modalità di scrittura dei dati dei file nell'archiviazione.
Sintassi
NTSYSAPI NTSTATUS ZwFlushBuffersFileEx(
[in] HANDLE FileHandle,
ULONG FLags,
PVOID Parameters,
ULONG ParametersSize,
[out] PIO_STATUS_BLOCK IoStatusBlock
);
Parametri
[in] FileHandle
Handle restituito da ZwCreateFile o ZwOpenFile per il file i cui buffer verranno scaricati. Questo parametro è obbligatorio e non può essere NULL.
FLags
Flag dell'operazione di scaricamento. i flag possono essere 0 o uno dei valori seguenti.
Parameters
Indirizzo del blocco di stato di I/O del chiamante. Questo parametro è obbligatorio e non può essere NULL.
ParametersSize
Dimensione, in byte, del blocco di parametri.
[out] IoStatusBlock
Indirizzo del blocco di stato di I/O del chiamante. Questo parametro è obbligatorio e non può essere NULL.
Valore restituito
ZwFlushBuffersFileEx restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:
Codice restituito | Descrizione |
---|---|
|
Il file risiede in un volume protetto da scrittura; si tratta di un codice di errore. |
|
Il file si trova in un volume che non è attualmente montato; si tratta di un codice di errore. |
|
Il file non ha accesso in scrittura o accodamento. |
Osservazioni
Un driver di filtro del file system può chiamare ZwFlushBuffersFileEx per inviare una richiesta di IRP_MJ_FLUSH_BUFFERS al file system per un determinato file. L'operazione di scaricamento è sincrona.
I driver minifiltro devono chiamare FltFlushBuffers invece di chiamare ZwFlushBuffersFileEx.
I chiamanti di ZwFlushBuffersFileEx devono essere in esecuzione in IRQL = PASSIVE_LEVEL e con API kernel speciali abilitate.
Fabbisogno
Requisito | Valore |
---|---|
client minimo supportato | Windows 8. |
piattaforma di destinazione | Universale |
intestazione |
ntifs.h (include Ntifs.h) |
libreria |
NtosKrnl.lib |
dll | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL (vedere la sezione Osservazioni). |
Vedere anche
uso di versioni Nt e Zw delle routine di Servizi di sistema nativi