Skip to main content

Crate ipt

Crate ipt 

Source
Expand description

Rust bindings to the Windows ipt.sys driver.

ipt.sys is the Windows kernel driver that manages Intel Processor Trace (Intel PT). There is no public Microsoft header or documentation for this interface; this crate provides its own typed request/response layouts for it.

Ipt::open the device, then call one Ipt method per driver operation (e.g. Ipt::start_process_trace, Ipt::get_trace_buffer). Each method builds its own request, issues the DeviceIoControl call and decodes the response — no manual buffer/IOCTL plumbing needed.

§Platform

This crate targets x86_64 on Windows only.

§Stability

ipt.sys is an internal OS component, not a supported public API. Its shape can change between Windows builds without notice. Treat this crate as best effort, only Microsoft & friends know how stable this really is.

Structs§

AddressFilterRangeResponse
Response to QueryThreadAddressFilterRange.
Ipt
Handle to the ipt.sys device, and the entry point for every operation in this crate.
IptOption
Supplied directly by the caller when starting a trace (StartProcessTrace/StartProcessTraceEx), echoed back by QueryProcessTraceConfiguration, and the same layout is written to/read from the registry by SetSystemWideTracingOption/SetPerImageTracingOption.
TraceBuffer
Output buffer for Ipt::get_trace_buffer: an 8-byte-aligned byte buffer sized to hold a GetTraceBuffer (opcode 2) response. Iterate the per-thread records it holds with TraceBuffer::iter.
TraceBufferIter
Iterator over a TraceBuffer’s per-thread trace records, returned by TraceBuffer::iter.

Enums§

AddressFilterMode
One IP-filtering range’s mode, as used by the ConfigureThreadAddressFilterRange request’s mode.

Constants§

NUM_TRIES_UNLIMITED
Sentinel for num_tries meaning “unlimited auto-start attempts”.