Funzione FsRtlMdlWriteCompleteDev (ntifs.h)

  • Articolo

La routine FsRtlMdlWriteCompleteDev libera le risorse allocate da FsRtlPrepareMdlWriteDev .

Sintassi

BOOLEAN FsRtlMdlWriteCompleteDev(
  [in]             PFILE_OBJECT   FileObject,
  [in]             PLARGE_INTEGER FileOffset,
  [in]             PMDL           MdlChain,
  [ in, optional ] PDEVICE_OBJECT DeviceObject
);

Parametri

[in] FileObject

Puntatore all'oggetto file.

[in] FileOffset

Puntatore a un valore che specifica l'offset dei byte iniziale all'interno della cache che contiene i dati.

[in] MdlChain

Puntatore a un elenco collegato di elenchi di descrittori di memoria (MDLs) allocati da FsRtlPrepareMdlWriteDev .

[ in, optional ] DeviceObject

Puntatore a un oggetto dispositivo in cui viene aperto il file.

Valore restituito

La routine FsRtlMdlWriteCompleteDev restituisceTRUE se l'operazione ha esito positivo e FALSE se l'operazione ha esito negativo o se il flag FO_WRITE_THROUGH è impostato nell'oggetto file.

Commenti

La routine FsRtlMdlWriteCompleteDev libera gli elenchi del descrittore di memoria (MDLs) allocati da FsRtlPrepareMdlWriteDev e sblocca la memoria cache bloccata da FsRtlPrepareMdlWriteDev .

Se il flag FO_WRITE_THROUGH è impostato sull'oggetto file a cui punta il parametro FileObject , FsRtlMdlWriteCompleteDev scarica immediatamente la memoria memorizzata nella cache su disco. Questa operazione di scaricamento entra nuovamente nel file system e può causare la generazione di un'eccezione se l'operazione di scaricamento non riesce.

Ogni chiamata a FsRtlPrepareMdlWriteDev deve essere seguita da una chiamata a FsRtlMdlWriteCompleteDev.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 8.
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regole di conformità DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Vedi anche

FsRtlPrepareMdlWriteDev