mirror of https://github.com/tongzx/nt5src
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
152 lines
3.0 KiB
152 lines
3.0 KiB
/*++
|
|
|
|
Copyright (c) 1999-2001 Microsoft Corporation
|
|
|
|
Module Name:
|
|
|
|
irptrace.cxx
|
|
|
|
Abstract:
|
|
|
|
This module implements an IRP tracing facility.
|
|
|
|
Author:
|
|
|
|
Keith Moore (keithmo) 10-Aug-1999
|
|
|
|
Revision History:
|
|
|
|
--*/
|
|
|
|
|
|
#include "precomp.h"
|
|
|
|
|
|
#if ENABLE_IRP_TRACE
|
|
|
|
|
|
/***************************************************************************++
|
|
|
|
Routine Description:
|
|
|
|
Creates a new (empty) IRP trace log buffer.
|
|
|
|
Arguments:
|
|
|
|
LogSize - Supplies the number of entries in the log.
|
|
|
|
ExtraBytesInHeader - Supplies the number of extra bytes to include
|
|
in the log header. This is useful for adding application-
|
|
specific data to the log.
|
|
|
|
Return Value:
|
|
|
|
PTRACE_LOG - Pointer to the newly created log if successful,
|
|
NULL otherwise.
|
|
|
|
--***************************************************************************/
|
|
PTRACE_LOG
|
|
CreateIrpTraceLog(
|
|
IN LONG LogSize,
|
|
IN LONG ExtraBytesInHeader
|
|
)
|
|
{
|
|
return CreateTraceLog(
|
|
IRP_TRACE_LOG_SIGNATURE,
|
|
LogSize,
|
|
ExtraBytesInHeader,
|
|
sizeof(IRP_TRACE_LOG_ENTRY)
|
|
);
|
|
|
|
} // CreateIrpTraceLog
|
|
|
|
|
|
/***************************************************************************++
|
|
|
|
Routine Description:
|
|
|
|
Destroys an IRP trace log buffer created with CreateIrpTraceLog().
|
|
|
|
Arguments:
|
|
|
|
pLog - Supplies the IRP trace log buffer to destroy.
|
|
|
|
--***************************************************************************/
|
|
VOID
|
|
DestroyIrpTraceLog(
|
|
IN PTRACE_LOG pLog
|
|
)
|
|
{
|
|
DestroyTraceLog( pLog );
|
|
|
|
} // DestroyIrpTraceLog
|
|
|
|
|
|
/***************************************************************************++
|
|
|
|
Routine Description:
|
|
|
|
Writes a new entry to the specified IRP trace log.
|
|
|
|
Arguments:
|
|
|
|
pLog - Supplies the log to write to.
|
|
|
|
Action - Supplies an action code for the new log entry.
|
|
|
|
pIrp - Supplies the IRP for the log entry.
|
|
|
|
pFileName - Supplies the filename of the routine writing the log entry.
|
|
|
|
LineNumber - Supplies he line number of the routine writing the log
|
|
entry.
|
|
|
|
--***************************************************************************/
|
|
VOID
|
|
WriteIrpTraceLog(
|
|
IN PTRACE_LOG pLog,
|
|
IN UCHAR Action,
|
|
IN PIRP pIrp,
|
|
IN PVOID pFileName,
|
|
IN USHORT LineNumber
|
|
)
|
|
{
|
|
IRP_TRACE_LOG_ENTRY entry;
|
|
USHORT irpSize;
|
|
|
|
//
|
|
// Initialize the entry.
|
|
//
|
|
|
|
RtlGetCallersAddress( &entry.pCaller, &entry.pCallersCaller );
|
|
|
|
entry.Action = Action;
|
|
entry.pIrp = pIrp;
|
|
|
|
entry.pFileName = pFileName;
|
|
entry.LineNumber = LineNumber;
|
|
entry.Processor = (UCHAR)KeGetCurrentProcessorNumber();
|
|
entry.pProcess = PsGetCurrentProcess();
|
|
entry.pThread = PsGetCurrentThread();
|
|
|
|
#if ENABLE_IRP_CAPTURE
|
|
irpSize = pIrp->Size;
|
|
if (irpSize > sizeof(entry.CapturedIrp))
|
|
{
|
|
irpSize = sizeof(entry.CapturedIrp);
|
|
}
|
|
|
|
RtlCopyMemory( entry.CapturedIrp, pIrp, irpSize );
|
|
#endif
|
|
|
|
//
|
|
// Write it to the logs.
|
|
//
|
|
|
|
WriteTraceLog( pLog, &entry );
|
|
|
|
} // WriteIrpTraceLog
|
|
|
|
|
|
#endif // ENABLE_IRP_TRACE
|
|
|