Funzione ZwFlushBuffersFile (ntifs.h)

  • Articolo

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
STATUS_MEDIA_WRITE_PROTECTED
 Il file si trova in un volume protetto da scrittura; si tratta di un codice di errore.
STATUS_VOLUME_DISMOUNTED
 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.

Nota Se la chiamata alla funzione ZwFlushBuffersFile si verifica in modalità utente, è necessario usare il nome "NtFlushBuffersFile" anziché "ZwFlushBuffersFile".
 
Per le chiamate dai driver in modalità kernel, le versioni **Nt*Xxx** e **Zw*Xxx** di una routine di Windows Native System Services possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni **Nt*Xxx** e **Zw*Xxx** di una routine, vedere [Uso delle routine di Servizi di sistema nativo](/windows-hardware/driver/kernel/using-nt-and-zw-version-of-the-native-system-services-routines).

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

FltFlushBuffers

IRP_MJ_FLUSH_BUFFERS

Uso di nt e zw versioni delle routine di Servizi di sistema nativo

ZwCreateFile

ZwOpenFile