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:
| Código de retorno | Descrição |
|---|---|
|
O evento foi registrado com êxito. |
|
Opcionalmente, as cadeias de caracteres Unicode fornecidas 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. |
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
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisWriteEventLogEntry (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisWriteEventLogEntry (NDIS 5.1)) no Windows XP. |
| Plataforma de Destino | Universal |
| Cabeçalho | ndis.h (inclua Ndis.h) |
| Biblioteca | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| Regras de conformidade da DDI | Irql_Miscellaneous_Function(ndis) |