Compartilhar via


função _RxLog (rxlog.h)

_RxLog faz parte das instalações de log de depuração rdbss (subsistema de buffer de unidade redirecionada). Ele usa uma cadeia de caracteres de formato e um número variável de parâmetros e formata uma cadeia de caracteres de saída para gravação como uma entrada de log de erros de E/S se o registro em log estiver habilitado.

Sintaxe

void _RxLog(
  PCSTR format,
  ...   
);

Parâmetros

format

Ponteiro para uma lista de argumentos variáveis que contém uma cadeia de caracteres de formato e um número variável de especificadores de formato que são substituídos pelos valores dos argumentos subsequentes.

...

Número variável de argumentos que correspondem ao formato especificado no formato cadeia de caracteres. Esses argumentos fornecem os dados a serem registrados, como cadeias de caracteres, inteiros e assim por diante.

Valor de retorno

Nenhum

Observações

É recomendável que a macro RxLog seja usada em vez de chamar diretamente a rotina de _RxLog. Em builds de varejo, a macro RxLog não é definida como nada.

Se o registro em log estiver habilitado, _RxLog gerará uma cadeia de caracteres para gravação como uma entrada de log de erros de E/S com base na cadeia de caracteres de formato e no número de variáveis passadas.

A rotina de _RxLog dá suporte aos seguintes descritores de cadeia de caracteres de formato:

  • %lN, %wN, %lS, %wS, %ld, %wd--um número
  • %x--um número hexadecimal
  • %c-- um caractere
  • %s--uma cadeia de caracteres ASCII
  • %Z--uma cadeia de caracteres Unicode que contém caracteres ASCII

A rotina de _RxLog é limitada a uma cadeia de caracteres de saída de, no máximo, 48 linhas, de modo que o formato cadeia de caracteres não pode conter mais de 48 caracteres\n'.

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho rxlog.h (inclua Rxlog.h)
IRQL <= APC_LEVEL

Consulte também

RxLogEventDirect

RxLogEventWithAnnotation

RxLogEventWithBufferDirect