Freigeben über


RECORDER_LOG_CREATE_PARAMS-Struktur (wpprecorder.h)

Die RECORDER_LOG_CREATE_PARAMS-Struktur ist ein Eingabeparameter für die WppRecorderLogCreate-Methode .

Syntax

typedef struct _RECORDER_LOG_CREATE_PARAMS {
  ULONG                  Size;
  ULONG                  LogTag;
  ULONG                  TotalBufferSize;
  ULONG                  ErrorPartitionSize;
  ULONG_PTR              LogIdentifierAppendValue;
  BOOLEAN                LogIdentifierAppendValueSet;
  ULONG                  LogIdentifierSize;
  CHAR                   LogIdentifier[RECORDER_LOG_IDENTIFIER_MAX_CHARS];
  WPP_RECORDER_TRI_STATE UseTimeStamp;
  WPP_RECORDER_TRI_STATE PreciseTimeStamp;
} RECORDER_LOG_CREATE_PARAMS, *PRECORDER_LOG_CREATE_PARAMS;

Member

Size

Größe dieser Struktur.

LogTag

Optionales Tag, das dem zugeordneten Speicher des Protokolls zugeordnet werden soll.

TotalBufferSize

Größe in Bytes für den Protokollbereich.

ErrorPartitionSize

Die Anzahl der Bytes aus TotalBufferSize , die zum Protokollieren von Fehlermeldungen verwendet wird. Null gibt an, dass keine Fehlerpartition vorhanden ist.

LogIdentifierAppendValue

Zahl/Zeiger, der an den Protokollbezeichner angefügt werden soll.

LogIdentifierAppendValueSet

Gibt an , ob LogIdentifierAppendValue festgelegt wurde.

LogIdentifierSize

Größe des LogIdentifier-Felds in Bytes (gemäß der Clientdefinition).

LogIdentifier[RECORDER_LOG_IDENTIFIER_MAX_CHARS]

Bezeichner, der gedruckt werden soll, wenn Debugnachrichten zusammengeführt werden. Lebt am Ende der Struktur, sodass es einfach bleibt, den Rest der Struktur zu lesen, wenn Clients zu einem bestimmten Zeitpunkt unterschiedliche Definitionen der Arraygröße haben.

UseTimeStamp

Ein WPP_RECORDER_TRI_STATE typisierter Wert, der Folgendes angibt:

  • Bei Festlegung auf WppRecorderTrue werden Zeitstempel der Millisekundengranularität zu WPP-Protokolleinträgen hinzugefügt.
  • Wenn WppRecorderFalse festgelegt ist, wird der Zeitstempel nicht aufgezeichnet.
  • Wenn WppRecorderDefault festgelegt ist, hat dies die gleiche Auswirkung wie WppRecorderFalse, es sei denn, die INF-Datei für das Treiberpaket legt WppRecorder_UseTimeStamp auf 1 fest. In diesem Fall bedeutet dies WppRecorderTrue.

Dieses Feld ist ab Windows 11 Version 22H2 verfügbar. Weitere Informationen finden Sie unter Inflight Trace Recorder (IFR) für die Protokollierung von Ablaufverfolgungen.

PreciseTimeStamp

Ein WPP_RECORDER_TRI_STATE typisierter Wert, der Folgendes angibt:

  • Wenn dieser Wert auf WppRecorderTrue festgelegt ist, werden zeitstempel eines Zehntels einer Mikrosekundengranularität zu WPP-Protokolleinträgen hinzugefügt.
  • Wenn WppRecorderFalse festgelegt ist, wird der Zeitstempel nicht aufgezeichnet.
  • Wenn WppRecorderDefault festgelegt ist, hat dies die gleiche Auswirkung wie WppRecorderFalse, es sei denn, die INF-Datei für das Treiberpaket legt WppRecorder_UseTimeStamp und WppRecorder_PreciseTimeStamp auf 1 fest. In diesem Fall bedeutet dies WppRecorderTrue.

Dieses Feld ist ab Windows 11 Version 22H2 verfügbar. Weitere Informationen finden Sie unter Inflight Trace Recorder (IFR) für die Protokollierung von Ablaufverfolgungen.

Anforderungen

Anforderung Wert
Header wpprecorder.h

Weitere Informationen

RECORDER_LOG_CREATE_PARAMS_INIT