DISK_PERFORMANCE - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// ntdddisk.h
typedef struct _DISK_PERFORMANCE {
LARGE_INTEGER BytesRead;
LARGE_INTEGER BytesWritten;
LARGE_INTEGER ReadTime;
LARGE_INTEGER WriteTime;
LARGE_INTEGER IdleTime;
ULONG ReadCount;
ULONG WriteCount;
ULONG QueueDepth;
ULONG SplitCount;
LARGE_INTEGER QueryTime;
ULONG StorageDeviceNumber;
WCHAR StorageManagerName[8];
} DISK_PERFORMANCE, *PDISK_PERFORMANCE;
View the official Windows Driver Kit DDI reference// winioctl.h
typedef struct _DISK_PERFORMANCE {
LARGE_INTEGER BytesRead;
LARGE_INTEGER BytesWritten;
LARGE_INTEGER ReadTime;
LARGE_INTEGER WriteTime;
LARGE_INTEGER IdleTime;
DWORD ReadCount;
DWORD WriteCount;
DWORD QueueDepth;
DWORD SplitCount;
LARGE_INTEGER QueryTime;
DWORD StorageDeviceNumber;
WCHAR StorageManagerName[8];
} DISK_PERFORMANCE, *PDISK_PERFORMANCE;
View the official Win32 API referenceNo description available.
The DISK_PERFORMANCE structure is used in conjunction with the IOCTL_DISK_PERFORMANCE request to collect summary disk statistics for purposes of measuring disk performance.
BytesReadContains a cumulative count of bytes read from the disk since the performance counters were enabled.
BytesWrittenContains a cumulative count of bytes written to the disk since the performance counters were enabled.
ReadTimeContains a cumulative time, expressed in increments of 100 nanoseconds, spent on disk reads since the performance counters were enabled.
WriteTimeContains a cumulative time, expressed in increments of 100 nanoseconds, spent on disk reads since the performance counters were enabled.
IdleTimeContains a cumulative time, expressed in increments of 100 nanoseconds, since the performance counters were enabled in which there was no disk activity.
ReadCountContains the number of disk accesses for reads since the performance counters were enabled.
WriteCountContains the number of disk accesses for writes since the performance counters were enabled.
QueueDepthContains a snapshot of the number of queued disk I/O requests at the time that the query for performance statistics was performed.
SplitCountContains the number of disk accesses by means of an associated IRP since the performance counters were enabled.
QueryTimeContains a timestamp indicating the system time at the moment that the query took place. System time is a count of 100-nanosecond intervals since January 1, 1601. System time is typically updated approximately every ten milliseconds. For more information about system time, seeKeQuerySystemTime.
StorageDeviceNumberContains a unique number assigned to every disk or volume across a particular storage type. The storage types are disk.sys, ftdisk.sys, and dmio.sys.
StorageManagerNameContains an 8-character string that indicates which device driver provided the performance statistics.
In Windows 2000, this can be either "LogiDisk" for the driver logidisk.sys or "PhysDisk" for the driver physdisk.sys. These drivers collect performance statistics for devices and physical disks respectively.
In Windows XP and later operating systems, this can be any of the following three strings: "FTDISK" for the driver ftdisk.sys, "DMIO" for the driver dmio.sys, or "PARTMGR" for the driver partmgr.sys. These three drivers collect performance statistics for basic disk volumes, dynamic disk volumes, and physical disks respectively. Note that these strings are 8-character case-sensitive strings with blank fill. For example, in the case of the string "FTDISK", the StorageManagerName character array should contain two trailing blanks ("FTDISK "), and in the case of the string "DMIO", the array should contain four trailing blanks ("DMIO ").
Counting halts whenever the performance counters are disabled, but the counters are not reset, so the cumulative values assigned to the structure members might potentially reflect disk activity across several enablings and disablings of the counters.
Provides disk performance information. It is used by the IOCTL_DISK_PERFORMANCE control code.
BytesReadThe number of bytes read.
BytesWrittenThe number of bytes written.
ReadTimeThe time it takes to complete a read.
WriteTimeThe time it takes to complete a write.
IdleTimeThe idle time.
ReadCountThe number of read operations.
WriteCountThe number of write operations.
QueueDepthThe depth of the queue.
SplitCountThe cumulative count of I/Os that are associated I/Os.
An associated I/O is a fragmented I/O, where multiple I/Os to a disk are required to fulfill the original logical I/O request. The most common example of this scenario is a file that is fragmented on a disk. The multiple I/Os are counted as split I/O counts.
QueryTimeThe system time stamp when a query for this structure is returned.
Use this member to synchronize between the file system driver and a caller.
StorageDeviceNumberThe unique number for a device that identifies it to the storage manager that is indicated in the StorageManagerName member.
StorageManagerNameThe name of the storage manager that controls this device.
Examples of storage managers are "PhysDisk," "FTDISK," and "DMIO".