CcUpdateExternalCacheInfoEx function (ntifs.h)

A file system calls CcUpdateExternalCacheInfoEx to ask the cache manager (Cc) to update dirty page statistics in the specified external cache information structure.

Syntax

NTSTATUS CcUpdateExternalCacheInfoEx(
  PVOID                ExternalCacheContext,
  PCC_DIRTY_PAGES_INFO DirtyPagesInfo
);

Parameters

ExternalCacheContext

[in] Pointer to the context that identifies the external cache structure to be updated. This context was returned by CcRegisterExternalCacheEx.

DirtyPagesInfo

[in] Pointer to a CC_DIRTY_PAGES_INFO structure that contains updated information about dirty page statistics. Cc ignores the dirty page thresholds part of this structure.

Return value

CcUpdateExternalCacheInfoEx returns STATUS_SUCCESS if the operation succeeds. Otherwise, it returns an appropriate error code such as the following.

Return code Description
STATUS_INVALID_PARAMETER The version in DirtyPagesInfo is invalid.

Remarks

Cc needs these updated values so it can accurately set the dirty page threshold and target.

Requirements

Requirement Value
Minimum supported client Windows 11, version 24H2
Header ntifs.h

See also

CcRegisterExternalCacheEx

CC_DIRTY_PAGES_INFO