Función NdisWriteEventLogEntry (ndis.h)

NdisWriteEventLogEntry registra un evento en el registro de eventos win32.

Sintaxis

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

Puntero al objeto de controlador del protocolo que registra este evento.

[in] EventCode

Especifica el código NDIS_STATUS_XXX que describe el evento.

[in] UniqueEventValue

Identifica esta instancia del mensaje de error.

[in] NumStrings

Especifica el número de punteros a cadenas Unicode en stringsList opcionales. Si StringsList es NULL, NumStrings debe ser cero.

[in, optional] StringsList

NULL o apunta a cadenas Unicode almacenadas en búfer. Estas cadenas, que describen el evento, se insertan en el registro de eventos win32 y se pueden examinar con el visor de eventos win32. Cada cadena debe ser una cadena Unicode terminada en NUL.

[in] DataSize

Especifica el número de bytes del búfer para los datos binarios en Data . Si Data es NULL, DataSize debe ser cero.

[in, optional] Data

NULL o apunta a los datos de volcado binario almacenados en búfer que son útiles para comprender el evento. Estos datos se pueden examinar con el visor de eventos win32.

Valor devuelto

NdisWriteEventLogEntry puede devolver uno de los siguientes valores:

Código devuelto	Descripción
NDIS_STATUS_SUCCESS	El evento se registró correctamente.
NDIS_STATUS_BUFFER_TOO_SHORT	Las cadenas Unicode proporcionadas opcionalmente y los datos de volcado binario superan el tamaño máximo permitido (MAX_EVENT_LOG_DATA_SIZE).
NDIS_STATUS_RESOURCES	NDIS no pudo asignar memoria para el registro de errores de E/S.

Comentarios

NdisWriteEventLogEntry asigna un registro de errores de E/S, rellena el registro con la información proporcionada sobre el evento y, a continuación, escribe el registro en el archivo de registro de errores de E/S. Un usuario puede ver el evento registrado, incluida una descripción opcional del evento o datos de volcado binario opcionales, con el visor de eventos win32.

El subproceso nt de registro de errores usa las cadenas proporcionadas en stringsList opcionales para rellenar los mensajes escritos en el registro de eventos de Win32. Cada cadena debe ser una cadena Unicode terminada en NUL. El administrador de E/S supone que la cadena inicial es el nombre del controlador que notifica el error o el nombre del dispositivo que provocó el error.

Las cadenas Unicode proporcionadas por el autor de la llamada deben leerse desde el Registro o deben ser independientes del idioma (es decir, las cadenas deben ser las mismas en cualquier idioma; por ejemplo, la cadena podría ser un nombre de archivo).

Los datos de volcado proporcionados por el autor de la llamada pueden ser cualquier dato binario (como los valores de registro) que sea útil para comprender el evento. El autor de la llamada no tiene que rellenar los datos binarios. Si es necesario, NdisWriteEventLogEntry rellena los datos de volcado binarios para que el tamaño final de los datos sea un múltiplo entero de sizeof(ULONG).

El sistema limita el tamaño total de los datos opcionales proporcionados a NdisWriteEventLogEntry. El tamaño combinado de la lista de cadenas y el volcado binario (posiblemente rellenado) debe ser menor o igual que MAX_EVENT_LOG_DATA_SIZE.

Solo los controladores de protocolo llaman a NdisWriteEventLogEntry. Los controladores de miniport deben llamar a NdisWriteErrorLogEntry para registrar eventos y errores.

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con controladores NDIS 6.0 y NDIS 5.1 (consulte NdisWriteEventLogEntry (NDIS 5.1)) en Windows Vista. Compatible con controladores NDIS 5.1 (consulte NdisWriteEventLogEntry (NDIS 5.1)) en Windows XP.
Plataforma de destino	Universal
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Reglas de cumplimiento de DDI	Irql_Miscellaneous_Function(ndis)

Consulte también

MiniportInitializeEx

MiniportResetEx

NdisMSetMiniportAttributes

NdisWriteErrorLogEntry