Funzione FsRtlMdlWriteCompleteDev (ntifs.h)
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) |