Win32_PerfFormattedData_PerfOS_Cache class
The Win32_PerfFormattedData_PerfOS_Cache formatted data class provides precalculated data from performance counters that monitor the file system cache, an area of physical memory that stores recently used data until the memory is required for other purposes. The cache permits access to the data without having to read from the disk. Because applications typically use the cache, the cache indicates application I/O operations. When memory is plentiful, the cache can grow, but when memory is scarce, the cache can become too small to be effective.
This class represents the Cache object in System Monitor and returns the same data you see in System Monitor. The original data source is the PerfOS performance library. This class derives its raw data from the corresponding raw class Win32_PerfRawData_PerfOS_Cache. Data is provided dynamically for this class from the performance library object by the WmiPerfInst provider.
Windows Server 2003 and Windows XP: WMI data for this class is supplied by the Formatted Performance Data Provider.
The following syntax is simplified from MOF code and shows all of the inherited properties, including the Frequency and Timestamp properties required for class display in System Monitor. For more information about required property qualifiers, see Property Qualifiers for Formatted Performance Counter Classes. For more information about CounterType values, see WMI Performance Counter Types.
Syntax
class Win32_PerfFormattedData_PerfOS_Cache : Win32_PerfFormattedData
{
uint32 AsyncCopyReadsPerSec;
uint32 AsyncDataMapsPerSec;
uint32 AsyncFastReadsPerSec;
uint32 AsyncMDLReadsPerSec;
uint32 AsyncPinReadsPerSec;
string Caption;
uint32 CopyReadHitsPercent;
uint32 CopyReadsPerSec;
uint32 DataFlushesPerSec;
uint32 DataFlushPagesPerSec;
uint32 DataMapHitsPercent;
uint32 DataMapPinsPerSec;
uint32 DataMapsPerSec;
string Description;
uint32 FastReadNotPossiblesPerSec;
uint32 FastReadResourceMissesPerSec;
uint32 FastReadsPerSec;
uint64 Frequency_Object;
uint64 Frequency_PerfTime;
uint64 Frequency_Sys100NS;
uint32 LazyWriteFlushesPerSec;
uint32 LazyWritePagesPerSec;
uint32 MDLReadHitsPercent;
uint32 MDLReadsPerSec;
string Name;
uint32 PinReadHitsPercent;
uint32 PinReadsPerSec;
uint32 ReadAheadsPerSec;
uint32 SyncCopyReadsPerSec;
uint32 SyncDataMapsPerSec;
uint32 SyncFastReadsPerSec;
uint32 SyncMDLReadsPerSec;
uint32 SyncPinReadsPerSec;
uint64 Timestamp_Object;
uint64 Timestamp_PerfTime;
uint64 Timestamp_Sys100NS;
};
Members
The Win32_PerfFormattedData_PerfOS_Cache class has these types of members:
- Properties
Properties
The Win32_PerfFormattedData_PerfOS_Cache class has these properties.
AsyncCopyReadsPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("AsyncCopyReadsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency of read operations from pages of the file system cache that require a memory copy of the data from the cache to the application's buffer. The application regains control immediately even if the disk must be accessed to retrieve the page.
AsyncDataMapsPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("AsyncDataMapsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency that an application using a file system such as NTFS to map a file page into the file system cache for reading, does not wait for the page to be retrieved if it is not in main memory.
AsyncFastReadsPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("AsyncFastReadsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency of read operations from the file system cache that bypass the installed file system and retrieve the data directly from the cache. Normally, file I/O requests invoke the appropriate file system to retrieve data from a file, but fast read permits data to be retrieved from the cache directly, if it is in the cache. If the data is not in the cache, the application program request does not wait until the data has been retrieved from disk, but gets control immediately.
AsyncMDLReadsPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("AsyncMDLReadsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency of read operations from the file system cache that use a Memory Descriptor List (MDL) to access the pages. The MDL contains the physical address of each page in the transfer, thus permitting Direct Memory Access (DMA) of the pages. If the accessed pages are not in main memory, the calling application program does not wait for the pages to fault in from disk.
AsyncPinReadsPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("AsyncPinReadsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency of reading data into the file system cache preparatory to writing the data back to disk. Pages read in this fashion are pinned in memory at the completion of the read. The file system regains control immediately even if the disk must be accessed to retrieve the page. While pinned, a page's physical address is not altered.
Caption
Data type: string
Access type: Read-only
Short textual description for the statistic or metric. This property is inherited from CIM_StatisticalInformation.
CopyReadHitsPercent
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_SAMPLE_FRACTION") , Counter ("CopyReadHitsPercent") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime") , Base ("CopyReadHitsPercent_Base")
Percentage of cache copy read requests that hit the cache, that is, they did not require a disk read to provide access to the page in the cache. A copy read is a file read operation that is satisfied by a memory copy from a page in the cache to the application's buffer. The LAN Redirector uses this method for retrieving information from the cache, as does the LAN Server for small transfers. This is a method used by the disk file systems as well.
CopyReadsPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("CopyReadsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency of read operations from pages of the file system cache that involve a memory copy of the cache data to the application's buffer. The LAN Redirector uses this method for retrieving information from the file system cache, as does the LAN Server for small transfers. This is a method used by the disk file systems as well.
DataFlushesPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("DataFlushesPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Rate at which the file system cache has flushed its contents to disk as the result of a request to flush or to satisfy a write-through file write request. More than one page can be transferred on each flush operation.
DataFlushPagesPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("DataFlushPagesPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Number of pages the file system cache has flushed to disk as a result of a request to flush or to satisfy a write-through file write request. More than one page can be transferred on each flush operation.
DataMapHitsPercent
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_SAMPLE_FRACTION") , Counter ("DataMapHitsPercent") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime") , Base ("DataMapsHitsPercent_Base")
Percentage of data maps in the file system cache that could be resolved without having to retrieve a page from the disk, because the page was already in physical memory.
DataMapPinsPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_SAMPLE_FRACTION") , Counter ("DataMapPinsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime") , Base ("DataMapPinsPerSec_Base")
Frequency of data maps in the file system cache that resulted in pinning a page in main memory, an action usually preparatory to writing to the file on disk. While pinned, a page's physical address in main memory and virtual address in the file system cache is not altered.
DataMapsPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("DataMapsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency that a file system such as NTFS, maps a page of a file into the file system cache to read the page.
Description
Data type: string
Access type: Read-only
Textual description of the statistic or metric. This property is inherited from CIM_StatisticalInformation.
FastReadNotPossiblesPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("FastReadNotPossiblesPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency of attempts by an API function call to bypass the file system to get to data in the file system cache that could not be honored without invoking the file system.
FastReadResourceMissesPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("FastReadResourceMissesPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency of cache misses caused by lack of available resources to satisfy the request.
FastReadsPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("FastReadsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency of read operations from the file system cache that bypass the installed file system and retrieve the data directly from the cache. Normally, file I/O requests invoke the appropriate file system to retrieve data from a file, but this path permits direct retrieval of data from the cache without file system involvement if the data is in the cache. Even if the data is not in the cache, one invocation of the file system is avoided.
Frequency_Object
Data type: uint64
Access type: Read-only
Frequency, in ticks per second, of Timestamp_Object. This property is defined by the provider. This property is inherited from Win32_Perf.
For more information about using uint64 values in scripts, see Scripting in WMI.
Frequency_PerfTime
Data type: uint64
Access type: Read-only
Frequency, in ticks per second, of Timestamp_Perftime. A value could be obtained by calling the Windows function QueryPerformanceCounter. This property is inherited from Win32_Perf.
For more information about using uint64 values in scripts, see Scripting in WMI.
Frequency_Sys100NS
Data type: uint64
Access type: Read-only
Frequency, in ticks per second, of Timestamp_Sys100NS (10000000). This property is inherited from Win32_Perf.
For more information about using uint64 values in scripts, see Scripting in WMI.
LazyWriteFlushesPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("LazyWriteFlushesPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Rate at which the Lazy Writer thread has written to disk. Lazy Writing is the process of updating the disk after the page has been changed in memory, so that the application that changed the file does not have to wait for the disk write to be complete before proceeding. More than one page can be transferred by each write operation.
LazyWritePagesPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("LazyWritePagesPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Rate at which the Lazy Writer thread has written to disk. Lazy Writing is the process of updating the disk after the page has been changed in memory, so that the application that changed the file does not have to wait for the disk write to be complete before proceeding. More than one page can be transferred on a single disk write operation.
MDLReadHitsPercent
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_SAMPLE_FRACTION") , Counter ("MDLReadHitsPercent") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime") , Base ("MDLReadHitsPercent_Base")
Percentage of Memory Descriptor List (MDL) Read requests to the file system cache that hit the cache, that is, did not require disk accesses to provide memory access to the pages in the cache.
MDLReadsPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("MDLReadsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency of read operations from the file system cache that use a Memory Descriptor List (MDL) to access the pages. The MDL contains the physical address of each page in the transfer, thus permitting Direct Memory Access (DMA) of the pages. If the accessed pages are not in main memory, the calling application program does not wait for the pages to fault in from disk.
Name
Data type: string
Access type: Read-only
Label by which the statistic or metric is known. When subclassed, the property can be overridden to be a key property. This property is inherited from CIM_StatisticalInformation.
PinReadHitsPercent
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_SAMPLE_FRACTION") , Counter ("PinReadHitsPercent") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime") , Base ("PinReadHitsPercent_Base")
Percentage of pin read requests that hit the file system cache; that is, those that did not require a disk read to provide access to the page in the file system cache. While pinned, a page's physical address in the file system cache is not altered. The LAN Redirector uses this method for retrieving data from the cache, as does the LAN Server for small transfers. This is usually the method used by the disk file systems as well.
PinReadsPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("PinReadsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency of reading data into the file system cache preparatory to writing the data back to disk. Pages read in this fashion are pinned in memory at the completion of the read. The file system regains control immediately even if the disk must be accessed to retrieve the page. While pinned, a page's physical address is not altered.
ReadAheadsPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("ReadAheadsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency of read operations from the file system cache in which the cache detects sequential access to a file. The read aheads permit the data to be transferred in larger blocks than those being requested by the application, reducing the overhead per access.
SyncCopyReadsPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("SyncCopyReadsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency of read operations from pages of the file system cache that involve a memory copy of the data from the cache to the application's buffer. The application regains control immediately even if the disk must be accessed to retrieve the page.
SyncDataMapsPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("SyncDataMapsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency that an application using a file system, such as NTFS to map a page of a file into the file system cache to read the page and does not wait for the page to be retrieved if it is not in main memory.
SyncFastReadsPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("SyncFastReadsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency of read operations from the file system cache that bypass the installed file system and retrieve the data directly from the cache. Normally, file I/O requests invoke the appropriate file system to retrieve data from a file, but direct retrieval, when possible, from the cache eliminates file system involvement. Even if the data is not in the cache, one invocation of the file system is avoided. If the data is not in the cache, the application program request waits until the data has been retrieved from disk.
SyncMDLReadsPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("SyncMDLReadsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency of read operations from the file system cache that use a Memory Descriptor List (MDL) to access the pages. The MDL contains the physical address of each page in the transfer, thus permitting Direct Memory Access (DMA) of the pages. If the accessed pages are not in main memory, the calling application program does not wait for the pages to fault in from disk.
SyncPinReadsPerSec
Data type: uint32
Access type: Read-only
Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("SyncPinReadsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")
Frequency of reading data into the file system cache preparatory to writing the data back to disk. Pages read in this fashion are pinned in memory at the completion of the read. The file system regains control immediately even if the disk must be accessed to retrieve the page. While pinned, a page's physical address is not altered.
Timestamp_Object
Data type: uint64
Access type: Read-only
Object-defined timestamp, defined by the provider. This property is inherited from Win32_Perf.
For more information about using uint64 values in scripts, see Scripting in WMI.
Timestamp_PerfTime
Data type: uint64
Access type: Read-only
High Performance counter timestamp. A value could be obtained by calling the Windows function QueryPerformanceCounter. This property is inherited from Win32_Perf.
For more information about using uint64 values in scripts, see Scripting in WMI.
Timestamp_Sys100NS
Data type: uint64
Access type: Read-only
Timestamp value in 100 nanosecond units. This property is inherited from Win32_Perf.
For more information about using uint64 values in scripts, see Scripting in WMI.
Remarks
All classes derived from Win32_Perf are designed to be used with a refresher object. For more information about how to create and use a refresher object in C++, see Accessing Performance Data in C++. For more information about how to create and use a refresher object using scripts, see Refreshing WMI Data in Scripts.
The performance class and property qualifiers determine how to interpret the class data. For more information, see Class Qualifiers for Performance Counter Classes and Property Qualifiers for Performance Counter Classes.
Examples
For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.
For C++ code examples, see WMI C++ Application Examples.
Requirements
Minimum supported client |
Windows XP |
Minimum supported server |
Windows Server 2003 |
Namespace |
\root\CIMV2 |
DLL |
WmiPerfInst.dll; WmiCookr.dll on Windows Server 2003 and Windows XP |
See also
Accessing WMI Preinstalled Performance Classes