Função FsRtlMdlWriteCompleteDev (ntifs.h)
A rotina FsRtlMdlWriteCompleteDev libera os recursos alocados por FsRtlPrepareMdlWriteDev .
Sintaxe
BOOLEAN FsRtlMdlWriteCompleteDev(
[in] PFILE_OBJECT FileObject,
[in] PLARGE_INTEGER FileOffset,
[in] PMDL MdlChain,
[ in, optional ] PDEVICE_OBJECT DeviceObject
);
Parâmetros
[in] FileObject
Um ponteiro para o objeto de arquivo.
[in] FileOffset
Um ponteiro para um valor que especifica o deslocamento de bytes inicial dentro do cache que contém os dados.
[in] MdlChain
Um ponteiro para uma lista vinculada de MDLs (listas de descritores de memória) alocadas por FsRtlPrepareMdlWriteDev .
[ in, optional ] DeviceObject
Um ponteiro para um objeto de dispositivo no qual o arquivo é aberto.
Retornar valor
A rotina FsRtlMdlWriteCompleteDev retornará TRUE se a operação for bem-sucedida e FALSE se a operação falhar ou se o sinalizador FO_WRITE_THROUGH estiver definido no objeto de arquivo.
Comentários
A rotina FsRtlMdlWriteCompleteDev libera as listas de descritores de memória (MDLs) alocadas por FsRtlPrepareMdlWriteDev e desbloqueia a memória de cache que FsRtlPrepareMdlWriteDev bloqueou.
Se o sinalizador FO_WRITE_THROUGH estiver definido no objeto de arquivo apontado pelo parâmetro FileObject , FsRtlMdlWriteCompleteDev liberará imediatamente a memória armazenada em cache no disco. Essa operação de liberação entra novamente no sistema de arquivos e pode fazer com que FsRtlMdlWriteCompleteDev gere uma exceção se a operação de liberação falhar.
Cada chamada para FsRtlPrepareMdlWriteDev deve ser seguida por uma chamada para FsRtlMdlWriteCompleteDev.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Disponível a partir do Windows 8. |
Plataforma de Destino | Universal |
Cabeçalho | ntifs.h (inclua Ntifs.h) |
Biblioteca | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
Regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |