Funzione ZwFlushBuffersFile (ntifs.h)
La routine ZwFlushBuffersFile viene chiamata da un driver di filtro del file system per inviare una richiesta di scaricamento per il file specificato nel file system.
Sintassi
NTSYSAPI NTSTATUS ZwFlushBuffersFile(
[in] HANDLE FileHandle,
[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.
[out] IoStatusBlock
Indirizzo del blocco di stato di I/O del chiamante. Questo parametro è obbligatorio e non può essere NULL.
Valore restituito
ZwFlushBuffersFile restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:
Codice restituito | Descrizione |
---|---|
|
Il file si trova 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. |
Commenti
Un driver di filtro del file system può chiamare ZwFlushBuffersFile per inviare una richiesta di IRP_MJ_FLUSH_BUFFERS al file system per un determinato file system. L'operazione di scaricamento è sincrona.
I driver minifilter devono chiamare FltFlushBuffers anziché chiamare ZwFlushBuffersFile.
I chiamanti di ZwFlushBuffersFile devono essere in esecuzione in IRQL = PASSIVE_LEVEL e con API kernel speciali abilitate.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista |
Piattaforma di destinazione | Universale |
Intestazione | ntifs.h (include Ntifs.h) |
Libreria | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL (vedere la sezione Osservazioni) |
Regole di conformità DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |
Vedi anche
Uso di nt e zw versioni delle routine di Servizi di sistema nativo