Função CcScheduleReadAhead (ntifs.h)

A rotina CcScheduleReadAhead executa leitura antecipada (também chamada de "leitura lenta") em um arquivo armazenado em cache. CcScheduleReadAhead nunca deve ser chamado diretamente. Em vez disso, a macro CcReadAhead deve ser chamada.

Sintaxe

void CcScheduleReadAhead(
  [in] PFILE_OBJECT   FileObject,
  [in] PLARGE_INTEGER FileOffset,
  [in] ULONG          Length
);

Parâmetros

[in] FileObject

Ponteiro para um objeto de arquivo para o arquivo no qual a leitura antecipada deve ser executada.

[in] FileOffset

Ponteiro para uma variável que especifica o deslocamento de bytes inicial dentro do arquivo armazenado em cache em que a última leitura ocorreu.

[in] Length

Comprimento em bytes do intervalo que foi lido pela última vez.

Retornar valor

Nenhum

Comentários

A macro CcReadAhead é um wrapper para CcScheduleReadAhead. Ele chamará CcScheduleReadAhead somente se Length>= 256. As medidas mostraram que chamar CcScheduleReadAhead para leituras menores realmente diminui o desempenho.

CcReadAhead e CcScheduleReadAhead só podem ser chamados após uma chamada bem-sucedida para CcCopyRead, CcFastCopyRead ou CcMdlRead.

Requisitos

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

Confira também

CcCopyRead

CcFastCopyRead

CcMdlRead

CcScheduleReadAhead

CcSetAdditionalCacheAttributes

CcSetReadAheadGranularity