Função NdisWriteEventLogEntry (ndis.h)

NdisWriteEventLogEntry registra um evento no log de eventos do Win32.

Sintaxe

NDIS_STATUS NdisWriteEventLogEntry(
  [in]           PVOID       LogHandle,
  [in]           NDIS_STATUS EventCode,
  [in]           ULONG       UniqueEventValue,
  [in]           USHORT      NumStrings,
  [in, optional] PVOID       StringsList,
  [in]           ULONG       DataSize,
  [in, optional] PVOID       Data
);

Parâmetros

[in] LogHandle

Ponteiro para o objeto de driver do protocolo que está registrando esse evento em log.

[in] EventCode

Especifica o código NDIS_STATUS_XXX que descreve o evento.

[in] UniqueEventValue

Identifica essa instância da mensagem de erro.

[in] NumStrings

Especifica o número de ponteiros para cadeias de caracteres Unicode na StringsList opcional. Se StringsList for NULL, NumStrings deverá ser zero.

[in, optional] StringsList

NULL ou aponta para cadeias de caracteres Unicode em buffer. Essas cadeias de caracteres, que descrevem o evento, são inseridas no log de eventos do Win32 e podem ser examinadas com o visualizador de eventos do Win32. Cada cadeia de caracteres deve ser uma cadeia de caracteres Unicode terminada em NUL.

[in] DataSize

Especifica o número de bytes no buffer para os dados binários em Dados . Se Data for NULL, DataSize deverá ser zero.

[in, optional] Data

NULL ou aponta para dados de despejo binário em buffer que são úteis para entender o evento. Esses dados podem ser examinados com o visualizador de eventos do Win32.

Retornar valor

NdisWriteEventLogEntry pode retornar um dos seguintes valores:

Comentários

NdisWriteEventLogEntry aloca um registro de log de erros de E/S, preenche o registro com as informações fornecidas sobre o evento e grava o registro no arquivo de log de erros de E/S. Um usuário pode exibir o evento registrado, incluindo uma descrição opcional do evento e/ou dados de despejo binário opcionais, com o visualizador de eventos win32.

O thread de log de erros do NT usa todas as cadeias de caracteres fornecidas na StringsList opcional para preencher mensagens gravadas no log de eventos do Win32. Cada cadeia de caracteres deve ser uma cadeia de caracteres Unicode terminada em NUL. O gerenciador de E/S pressupõe que a cadeia de caracteres inicial seja o nome do driver que relata o erro ou o nome do dispositivo que causou o erro.

As cadeias de caracteres Unicode fornecidas pelo chamador devem ser lidas do registro ou devem ser independentes de idioma (ou seja, as cadeias de caracteres devem ser as mesmas em qualquer idioma , por exemplo, a cadeia de caracteres pode ser um nome de arquivo).

Os dados de despejo fornecidos pelo chamador podem ser dados binários (como valores de registro) que são úteis para entender o evento. O chamador não precisa preencher os dados binários. Se necessário, NdisWriteEventLogEntry preenche os dados de despejo binário para que o tamanho final dos dados seja um múltiplo integral de sizeof(ULONG).

O sistema limita o tamanho total dos dados opcionais fornecidos a NdisWriteEventLogEntry. O tamanho combinado da lista de cadeias de caracteres e o despejo binário (possivelmente preenchido) devem ser menores ou iguais a MAX_EVENT_LOG_DATA_SIZE.

NdisWriteEventLogEntry é chamado apenas por drivers de protocolo. Os drivers de miniport devem chamar NdisWriteErrorLogEntry para registrar eventos e erros.

Requisitos

Confira também

MiniportInitializeEx

MiniportResetEx

NdisMSetMiniportAttributes

NdisWriteErrorLogEntry