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 driver do protocolo que está registrando esse evento.
[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 no StringsListopcional. 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 Win32. Cada cadeia de caracteres deve ser uma cadeia de caracteres Unicode terminada por NUL.
[in] DataSize
Especifica o número de bytes no buffer para os dados binários em Data . 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 Win32.
Valor de retorno
NdisWriteEventLogEntry pode retornar um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
|
O evento foi registrado com êxito. |
|
As cadeias de caracteres Unicode fornecidas opcionalmente e os dados de despejo binário excedem o tamanho máximo permitido (MAX_EVENT_LOG_DATA_SIZE). |
|
O NDIS não pôde alocar memória para o registro de log de erros de E/S. |
Observações
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 em log, 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 no stringsList opcional para preencher mensagens escritas no log de eventos do Win32. Cada cadeia de caracteres deve ser uma cadeia de caracteres Unicode terminada por NUL. O gerente de E/S pressupõe que a cadeia de caracteres inicial seja o nome do driver relatando 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 quaisquer dados binários (como valores de registro) que sejam úteis para entender o evento. O chamador não precisa armazenar os dados binários. Se necessário, NdisWriteEventLogEntry armazena os dados de despejo binário para que o tamanho dos dados finais seja um múltiplo integral de tamanhos de(ULONG).
O sistema limita o tamanho total dos dados opcionais fornecidos para NdisWriteEventLogEntry. O tamanho combinado da lista de cadeias de caracteres e o despejo binário (possivelmente acolchoado) 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 em log eventos e erros.