Função CcSetCacheFileSizes (ntifs.h)
A função CcSetCacheFileSizes define os tamanhos de arquivo do gerenciador de cache por ponteiros de objeto de seção.
Sintaxe
NTSTATUS CcSetCacheFileSizes(
[in] PSECTION_OBJECT_POINTERS SectionObjectPointer,
[in] PCC_FILE_SIZES FileSizes
);
Parâmetros
[in] SectionObjectPointer
Ponteiro para uma estrutura SECTION_OBJECT_POINTERS que contém as informações do objeto de seção.
[in] FileSizes
Ponteiro para uma estrutura CC_FILE_SIZES que especifica o tamanho do arquivo a ser definido.
Valor de retorno
CcSetCacheFileSizes retornará STATUS_SUCCESS se o tamanho do arquivo tiver sido alterado com êxito e, se for necessário um limpeza, a limpeza foi bem-sucedida. Caso contrário, ele retorna um código NSTATUS sem êxito, como STATUS_INSUFFICIENT_RESOURCES, e pode gerar uma exceção de status.
Em relação à geração de uma exceção de status no erro:
Se a operação causar CcSetCacheFileSizes liberar e/ou limpar o arquivo, CcSetCacheFileSizes não gerará erros; ele apenas retorna o código NTSTATUS não bem-sucedido apropriado da operação de liberação ou limpeza.
Se a operação causar CcSetCacheFileSizes estender a seção, CcSetCacheFileSizes gerará qualquer erro que ocorrer durante essa extensão.
Observações
Se a operação causar CcSetCacheFileSizes estender a seção e ocorrer uma falha, CcSetCacheFileSizes gerará uma exceção de status para essa falha específica. Por exemplo, se ocorrer uma falha de alocação de pool, CcSetCacheFileSizes gerará uma exceção STATUS_INSUFFICIENT_RESOURCES. Portanto, para obter controle se ocorrer uma falha, o driver deverá encapsular a chamada para ccSetCacheFileSizes em uma instrução try-except ou try-finally.
O sistema de arquivos deve garantir que o mapa de cache seja válido e permanecerá assim durante essa chamada.
Para obter o tamanho do arquivo armazenado em cache, passe SectionObjectPointer para CcGetCacheFileSize.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 11, versão 22H2 |
| cabeçalho | ntifs.h |