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 |
|---|---|
|
El evento se registró correctamente. |
|
Las cadenas Unicode proporcionadas opcionalmente y los datos de volcado binario superan el tamaño máximo permitido (MAX_EVENT_LOG_DATA_SIZE). |
|
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) |