Função FsRtlPrepareMdlWriteDev (ntifs.h)

Artigo
12/21/2024

A rotina FsRtlPrepareMdlWriteDev retorna uma lista vinculada de MDLs (listas de descritores de memória) que apontam para o intervalo especificado de dados de arquivo armazenados em cache para gravar dados diretamente no cache.

Sintaxe

BOOLEAN FsRtlPrepareMdlWriteDev(
  [in]             PFILE_OBJECT     FileObject,
  [in]             PLARGE_INTEGER   FileOffset,
  [in]             ULONG            Length,
  [in]             ULONG            LockKey,
  [out]            PMDL             *MdlChain,
  [out]            PIO_STATUS_BLOCK IoStatus,
  [ 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] Length

O comprimento em bytes dos dados a serem lidos do cache.

[in] LockKey

Um valor associado ao intervalo de bytes a ser bloqueado. Se o intervalo a ser bloqueado se sobrepor a outro intervalo que já está bloqueado com um bloqueio nãoclusivo ou se o intervalo a ser lido for um subconjunto de outro intervalo que já está bloqueado não exclusivamente, o valor nesse parâmetro deverá ser a chave para esse bloqueio não existente. O bloqueio deve ser mantido pelo processo pai do thread de chamada. Caso contrário, esse parâmetro não terá efeito.

[out] MdlChain

Na saída, um ponteiro para uma lista vinculada de MDLs (listas de descritores de memória) que apontam para o intervalo de bytes dentro dos dados armazenados em cache.

[out] IoStatus

Um ponteiro para uma estrutura IO_STATUS_BLOCK que, na saída, contém o status da transferência. Se a operação for bem-sucedida, IoStatus.Status será definido como STATUS_SUCCESS. Caso contrário, ele será definido como um código de erro NTSTATUS apropriado. IoStatus.Information é definido como o número real de bytes que a rotina bloqueou com êxito.

[ in, optional ] DeviceObject

Um ponteiro para um objeto de dispositivo no qual o arquivo é aberto.

Valor de retorno

A rotina FsRtlPrepareMdlWriteDev retornará TRUE se a operação for bem-sucedida e FALSE se a operação falhar.

Observações

FsRtlPrepareMdlWriteDev é semelhante a FsRtlCopyWrite, exceto que FsRtlPrepareMdlWriteDev não copia dados para o cache. Em vez disso, as páginas físicas que o chamador substituirão estão bloqueadas na memória e FsRtlPrepareMdlWriteDev retorna uma ou mais listas de descritores de memória (MDLs) que apontam para o intervalo de bytes especificado. As páginas bloqueadas permanecem bloqueadas até que o chamador chame FsRtlMdlWriteCompleteDev.

As páginas às quais os MDLs apontam estão bloqueadas na memória, mas não são mapeadas no espaço do sistema. O chamador pode executar esse mapeamento chamando MmGetSystemAddressForMdlSafe.

Mesmo se a chamada para FsRtlPrepareMdlWriteDev falhar, um ou mais MDLs poderão ter sido alocados. O chamador pode examinar o valor de IoStatus.Information para determinar se isso ocorreu. Se tiver, o chamador deverá chamar FsRtlMdlWriteCompleteDev para liberar os MDLs alocados.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Consulte também

FsRtlMdlWriteCompleteDev

FsRtlCopyWrite

MmGetSystemAddressForMdlSafe

Compartilhar via