Função FsRtlMdlReadDev (ntifs.h)

A rotina FsRtlMdlReadDev retorna uma MDL (lista de descritores de memória) que aponta diretamente para o intervalo de bytes especificado no cache de arquivos.

Sintaxe

BOOLEAN FsRtlMdlReadDev(
  [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 um objeto de arquivo para o arquivo armazenado em cache.

[in] FileOffset

Um ponteiro para uma variável que especifica o deslocamento de bytes inicial dentro do arquivo armazenado em 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).

[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.

Retornar valor

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

Comentários

A rotina FsRtlMdlReadDev ignora o mecanismo IRP usual e retorna uma lista vinculada de MDL (listas de descritores de memória) que o chamador pode usar para acessar diretamente os dados do arquivo armazenado em cache. Essa operação não copia nem armazena dados em buffer e, portanto, é muito mais rápida do que uma leitura normal.

A rotina é semelhante a CcMdlRead e FltFastIoMdlRead. FltFastIoMdlRead, CcMdlRead e FsRtlMdlReadDev bloqueiam as páginas que contêm os dados de arquivo armazenados em cache para impedir que o sistema troque essas páginas para o arquivo de página. As páginas permanecem bloqueadas na memória até que o chamador invoque a rotina FsRtlMdlReadCompleteDev .

Requisitos

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

Confira também

CcMdlRead

FsRtlMdlReadCompleteDev

FsRtlMdlReadEx