Função RxLogEventDirect (rxprocs.h)
RxLogEventDirect é chamado para registrar um erro no log de erros de E/S.
É recomendável que a macro RXLogEvent ou a macro RxLogFailure seja usada em vez de chamar essa rotina diretamente.
Sintaxe
void RxLogEventDirect(
[in] IN PRDBSS_DEVICE_OBJECT DeviceObject,
[in] IN PUNICODE_STRING OriginatorId,
[in] IN ULONG EventId,
[in] IN NTSTATUS Status,
[in] IN ULONG Line
);
Parâmetros
[in] DeviceObject
Um ponteiro para o objeto de dispositivo RDBSS.
[in] OriginatorId
Uma cadeia de caracteres que indica o chamador que gera o erro.
[in] EventId
O valor que indica o valor do 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.
[in] Status
O valor que indica o código status de uma rotina que indica uma falha.
[in] Line
O número de linha no arquivo de código-fonte em que essa falha ocorreu.
Retornar valor
Nenhum
Comentários
RxLogEventDirect chama internamente a rotina RxLogEventWithAnnotation para criar e gravar a entrada de log.
O tamanho da entrada do log de erros de E/S é limitado a um comprimento de 255 caracteres. Portanto, se o comprimento combinado do OriginatorId mais o tamanho da parte fixa do log de erros de E/S exceder 255, nenhuma entrada de log de erros de E/S será criada.
A rotina RxLogEventWithAnnotation precisa alocar memória para criar a entrada de log de erros de E/S . Consequentemente, RxLogEventDirect 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 |