Edit

DiskIo class

  • Article

This class is the parent class for disk I/O events.

The following syntax is simplified from MOF code.

Syntax

[Guid("{3d6fa8d4-fe05-11d0-9dda-00c04fd7ba7c}")]
class DiskIo : MSNT_SystemTrace
{
};

Members

The DiskIo class does not define any members.

Remarks

To enable disk I/0 events in an NT Kernel logging session, specify the EVENT_TRACE_FLAG_DISK_IO flag in the EnableFlags member of an EVENT_TRACE_PROPERTIES structure when calling the StartTrace function. You can also specify one or more of the following flags:

  • EVENT_TRACE_FLAG_DISK_IO_INIT
  • EVENT_TRACE_FLAG_DRIVER

Event trace consumers can implement special processing for disk I/O events by calling the SetTraceCallback function and specifying DiskIoGuid as the pGuid parameter. Use the following event types to identify the actual disk I/O event when consuming events.

Event type Description
EVENT_TRACE_TYPE_IO_READ(Event type value is 10)
 Read event. The DiskIo_TypeGroup1 MOF class defines the event data for this event.
EVENT_TRACE_TYPE_IO_WRITE(Event type value is 11)
 Write event. The DiskIo_TypeGroup1 MOF class defines the event data for this event.
EVENT_TRACE_TYPE_IO_READ_INIT(Event type value is 12)
 Initialize read event. The DiskIo_TypeGroup2 MOF class defines the event data for this event.
EVENT_TRACE_TYPE_IO_WRITE_INIT(Event type value is 13)
 Initialize write event. The DiskIo_TypeGroup2 MOF class defines the event data for this event.
EVENT_TRACE_TYPE_IO_FLUSH(Event type value is 14)
 Initialize write event. The DiskIo_TypeGroup3 MOF class defines the event data for this event.
EVENT_TRACE_TYPE_IO_FLUSH_INIT(Event type value is 15)
 Initialize flush event. The DiskIo_TypeGroup2 MOF class defines the event data for this event.
EVENT_TRACE_TYPE_IO_REDIRECTED_INIT(Event type value is 16)
 Initialize redirected event. Redirected IO events are used to map disk IOs to a Windows Imaging Format (WIM) to the filename within the WIM.
Event type value is 52
 Driver complete request event. The DriverCompleteRequest MOF class defines the event data for this event.
Event type value is 53
 Driver complete request return event. The DriverCompleteRequestReturn MOF class defines the event data for this event.
Event type value is 37
 Driver completion routine event. The DriverCompletionRoutine MOF class defines the event data for this event.
Event type value is 34
 Driver major function call event. The DriverMajorFunctionCall MOF class defines the event data for this event.
Event type value is 35
 Driver major function call return event. The DriverMajorFunctionReturn MOF class defines the event data for this event.

 

The disk I/0 provider cannot identify which file is read or written during a disk I/O event. To retrieve the name of the file associated with the disk I/O event, enable the file I/0 event provider.

Disk I/O events are recorded at the I/O completion time. To determine when the I/O operation began, use the initialization events, for example, EVENT_TRACE_TYPE_IO_READ_INIT.

Requirements

Requirement Value
Minimum supported client
 Windows XP [desktop apps only]
Minimum supported server
 Windows Server 2003 [desktop apps only]

See also

DiskIo_TypeGroup1

DiskIo_TypeGroup2

DiskIo_TypeGroup3

DriverCompleteRequest

DriverCompleteRequestReturn

DriverCompletionRoutine

DriverMajorFunctionCall

DriverMajorFunctionReturn