Compartilhar via


estrutura RECORDER_LOG_CREATE_PARAMS (wpprecorder.h)

A estrutura RECORDER_LOG_CREATE_PARAMS é um parâmetro de entrada para o método WppRecorderLogCreate .

Sintaxe

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;

Membros

Size

Tamanho dessa estrutura.

LogTag

Marca opcional a ser associada à memória alocada do log.

TotalBufferSize

Tamanho em bytes para a área de log.

ErrorPartitionSize

O número de bytes de TotalBufferSize usados para registrar mensagens de erro. Zero indica nenhuma partição de erro.

LogIdentifierAppendValue

Número/ponteiro para acrescentar ao identificador de log.

LogIdentifierAppendValueSet

Especifica se LogIdentifierAppendValue foi definido.

LogIdentifierSize

Tamanho do campo LogIdentifier , em bytes (de acordo com a definição do cliente).

LogIdentifier[RECORDER_LOG_IDENTIFIER_MAX_CHARS]

Identificador a ser impresso quando as mensagens de depuração são mescladas. Reside no final da estrutura para que, se em algum momento os clientes tiverem definições diferentes do tamanho da matriz, será simples ler o restante da estrutura.

UseTimeStamp

Um valor do tipo WPP_RECORDER_TRI_STATE que indica:

  • Se definido como WppRecorderTrue, carimbos de data/hora de granularidade de milissegundo serão adicionados às entradas de log do WPP.
  • Se definido como WppRecorderFalse, o carimbo de data/hora não será gravado.
  • Se definido como WppRecorderDefault, ele terá o mesmo efeito que WppRecorderFalse, a menos que o arquivo INF do pacote de driver defina WppRecorder_UseTimeStamp como 1, nesse caso, significa WppRecorderTrue.

Esse campo está disponível a partir do Windows 11, versão 22H2. Para obter mais informações, consulte IfR (Gravador de Rastreamento de Inflight) para registrar rastreamentos em log.

PreciseTimeStamp

Um valor do tipo WPP_RECORDER_TRI_STATE que indica:

  • Se definido como WppRecorderTrue, carimbos de data/hora de um décimo de granularidade de microssegundos serão adicionados às entradas de log do WPP.
  • Se definido como WppRecorderFalse, o carimbo de data/hora não será gravado.
  • Se definido como WppRecorderDefault, ele terá o mesmo efeito que WppRecorderFalse, a menos que o arquivo INF do pacote de driver defina WppRecorder_UseTimeStamp e WppRecorder_PreciseTimeStamp como 1, nesse caso significa WppRecorderTrue.

Esse campo está disponível a partir do Windows 11, versão 22H2. Para obter mais informações, consulte IfR (Gravador de Rastreamento de Inflight) para registrar rastreamentos em log.

Requisitos

Requisito Valor
Cabeçalho wpprecorder.h

Confira também

RECORDER_LOG_CREATE_PARAMS_INIT