Função RxLogEventWithAnnotation (rxprocs.h)

RxLogEventWithAnnotation aloca uma estrutura de log de erros de E/S, preenche-a com informações e grava a entrada no log de erros de E/S.

Sintaxe

void RxLogEventWithAnnotation(
  [in] IN PRDBSS_DEVICE_OBJECT DeviceObject,
       IN ULONG                EventId,
       IN NTSTATUS             Status,
       IN PVOID                DataBuffer,
       IN USHORT               DataBufferLength,
       IN PUNICODE_STRING      Annotation,
  [in] IN ULONG                AnnotationCount
);

Parâmetros

[in] DeviceObject

Um ponteiro para o objeto de dispositivo RDBSS.

EventId

O valor que indica o código de log de erros de E/S que é diferente de um valor NTSTATUS retornado por uma rotina. Os valores de código de log de erros de E/S legais são definidos no arquivo de cabeçalho ntiolog.h incluído no SDK do Microsoft Windows e no Visual Studio.

Status

O valor que indica o código status de uma rotina que indica uma falha.

DataBuffer

Um ponteiro para um buffer de dados bruto a ser adicionado à estrutura do log de erros de E/S.

DataBufferLength

O comprimento do buffer de dados brutos a ser adicionado à estrutura do log de erros de E/S.

Annotation

Um ponteiro para quaisquer cadeias de caracteres de anotação a serem adicionadas à estrutura de log de erros de E/S.

[in] AnnotationCount

A contagem do número de cadeias de caracteres de anotação a serem adicionadas à estrutura do log de erros de E/S.

Retornar valor

Nenhum

Comentários

Um minidiretório de rede chamaria RxLogEventWithAnnotation para registrar um erro de E/S.

O tamanho da entrada do log de erros de E/S é limitado a um comprimento de 255 caracteres. Portanto, se o comprimento combinado dos parâmetros Id, RawDataBuffer e Annotations mais o tamanho da parte fixa da entrada de log de erros de E/S exceder 255, rxLogEventWithAnnotation falhará silenciosamente e nenhuma entrada de log de erro de E/S será criada.

A rotina RxLogEventWithAnnotation precisa alocar memória para criar a entrada de log de erros de E/S . Consequentemente, RxLogEventWithAnnotation poderá falhar silenciosamente se a alocação de memória falhar.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho rxprocs.h (inclua Rxprocs.h, Rxstruc.h)
IRQL <= APC_LEVEL

Confira também

RxLogEventDirect

RxLogEventWithBufferDirect

_RxLog