estructura DISK_PERFORMANCE (ntdddisk.h)

La estructura DISK_PERFORMANCE se usa junto con la solicitud de IOCTL_DISK_PERFORMANCE para recopilar estadísticas de disco de resumen con el fin de medir el rendimiento del disco.

Sintaxis

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;

Miembros

BytesRead

Contiene un recuento acumulativo de bytes leídos desde el disco, ya que se habilitaron los contadores de rendimiento.

BytesWritten

Contiene un recuento acumulativo de bytes escritos en el disco, ya que se habilitaron los contadores de rendimiento.

ReadTime

Contiene un tiempo acumulado, expresado en incrementos de 100 nanosegundos, invertidos en lecturas de disco desde que se habilitaron los contadores de rendimiento.

WriteTime

Contiene un tiempo acumulado, expresado en incrementos de 100 nanosegundos, invertidos en lecturas de disco desde que se habilitaron los contadores de rendimiento.

IdleTime

Contiene un tiempo acumulado, expresado en incrementos de 100 nanosegundos, ya que los contadores de rendimiento se habilitaron en los que no había ninguna actividad de disco.

ReadCount

Contiene el número de accesos de disco para lecturas, ya que se habilitaron los contadores de rendimiento.

WriteCount

Contiene el número de accesos de disco para las escrituras, ya que se habilitaron los contadores de rendimiento.

QueueDepth

Contiene una instantánea del número de solicitudes de E/S de disco en cola en el momento en que se realizó la consulta de estadísticas de rendimiento.

SplitCount

Contiene el número de accesos de disco por medio de un IRP asociado desde que se habilitaron los contadores de rendimiento.

QueryTime

Contiene una marca de tiempo que indica la hora del sistema en el momento en que tuvo lugar la consulta. La hora del sistema es un recuento de intervalos de 100 nanosegundos desde el 1 de enero de 1601. Normalmente, la hora del sistema se actualiza aproximadamente cada diez milisegundos. Para obtener más información sobre la hora del sistema, consulteKeQuerySystemTime.

StorageDeviceNumber

Contiene un número único asignado a cada disco o volumen en un tipo de almacenamiento determinado. Los tipos de almacenamiento se disk.sys, ftdisk.sysy dmio.sys.

StorageManagerName[8]

Contiene una cadena de 8 caracteres que indica qué controlador de dispositivo proporcionó las estadísticas de rendimiento.

• En Windows 2000, puede ser "LogiDisk" para el controlador logidisk.sys o "PhysDisk" para el controlador physdisk.sys. Estos controladores recopilan estadísticas de rendimiento para dispositivos y discos físicos, respectivamente.

• En Windows XP y sistemas operativos posteriores, puede ser cualquiera de las tres cadenas siguientes: "FTDISK" para el controlador ftdisk.sys, "DMIO" para el controlador dmio.syso "PARTMGR" para el controlador partmgr.sys. Estos tres controladores recopilan estadísticas de rendimiento para volúmenes de disco básicos, volúmenes de disco dinámicos y discos físicos, respectivamente. Tenga en cuenta que estas cadenas distinguen mayúsculas de minúsculas de 8 caracteres con relleno en blanco. Por ejemplo, en el caso de la cadena "FTDISK", la matriz de caracteres StorageManagerName debe contener dos espacios en blanco finales ("FTDISK") y, en el caso de la cadena "DMIO", la matriz debe contener cuatro espacios en blanco finales ("DMIO").

Comentarios

El recuento se detiene cada vez que se deshabilitan los contadores de rendimiento, pero los contadores no se restablecen, por lo que los valores acumulativos asignados a los miembros de la estructura podrían reflejar potencialmente la actividad del disco en varias habilitaciones y deshabilitaciones de los contadores.

Requisitos

Consulte también

IOCTL_DISK_PERFORMANCE

IOCTL_DISK_PERFORMANCE_OFF