Compartilhar via


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
NDIS_STATUS_SUCCESS
O evento foi registrado com êxito.
NDIS_STATUS_BUFFER_TOO_SHORT
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).
NDIS_STATUS_RESOURCES
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)

Confira também

MiniportInitializeEx

MiniportResetEx

NdisMSetMiniportAttributes

NdisWriteErrorLogEntry