Función NdisWriteErrorLogEntry (ndis.h)
NdisWriteErrorLogEntry escribe una entrada en el archivo de registro de errores de E/S del sistema.
Sintaxis
void NdisWriteErrorLogEntry(
[in] NDIS_HANDLE NdisAdapterHandle,
[in] NDIS_ERROR_CODE ErrorCode,
[in] ULONG NumberOfErrorValues,
...
);
Parámetros
[in] NdisAdapterHandle
Especifica el identificador que representa la NIC que es la causa del error de E/S que se va a registrar. Este identificador es un parámetro de entrada para MiniportInitializeEx.
[in] ErrorCode
Especifica el código NDIS_ERROR_CODE_XXX que describe mejor el error de E/S como uno de los siguientes valores:
NDIS_ERROR_CODE_RESOURCE_CONFLICT
El controlador no pudo acceder a un recurso necesario.
NDIS_ERROR_CODE_OUT_OF_RESOURCES
El hardware o el controlador se quedó sin recursos.
NDIS_ERROR_CODE_HARDWARE_FAILURE
El controlador detectó un error de hardware.
NDIS_ERROR_CODE_ADAPTER_NOT_FOUND
No se encontró el adaptador de red.
NDIS_ERROR_CODE_INTERRUPT_CONNECT
Error en el registro de interrupciones.
NDIS_ERROR_CODE_DRIVER_FAILURE
Error de controlador que no coincide con ninguna de las otras condiciones de error.
NDIS_ERROR_CODE_BAD_VERSION
El controlador detectó un error de coincidencia de versión.
NDIS_ERROR_CODE_TIMEOUT
Ha expirado un tiempo de espera.
NDIS_ERROR_CODE_NETWORK_ADDRESS
Una dirección de red no es válida.
NDIS_ERROR_CODE_UNSUPPORTED_CONFIGURATION
No se admite la configuración del controlador solicitada.
NDIS_ERROR_CODE_INVALID_VALUE_FROM_ADAPTER
El hardware del adaptador de red proporcionó un valor no válido.
NDIS_ERROR_CODE_MISSING_CONFIGURATION_PARAMETER
Falta un parámetro de configuración de controlador en el Registro.
NDIS_ERROR_CODE_BAD_IO_BASE_ADDRESS
La dirección base de E/S del hardware del adaptador de red no es válida.
NDIS_ERROR_CODE_RECEIVE_SPACE_SMALL
La cantidad de memoria del búfer de recepción disponible es demasiado pequeña para recibir datos.
NDIS_ERROR_CODE_ADAPTER_DISABLED
El hardware del adaptador de red está deshabilitado.
[in] NumberOfErrorValues
Especifica el número de valores de ULONG que se van a seguir este parámetro.
...
Especifica una matriz de ULONG de tamaño variable asociada al error que se va a registrar.
Valor devuelto
None
Observaciones
NdisWriteErrorLogEntry asigna un registro de errores de E/S, rellena el registro con la información proporcionada sobre el error y, a continuación, escribe el registro en el archivo de registro de errores de E/S.
El sistema coloca un límite en el tamaño potencial de un registro de errores. Para Windows 2000 y versiones posteriores, el límite se define como ERROR_LOG_MAXIMUM_SIZE. NumberOfErrorValues pasado a NdisWriteErrorLogEntry, por lo tanto, tiene un límite aplicado por el sistema, que es considerablemente menor que el valor máximo posible para un ULONG.
En la práctica, algunos autores de llamadas de NdisWriteErrorLogEntry incluso se aproximan al límite de NumberOfErrorValues porque proporcionar muchos valores NDIS_STATUS_XXX adicionales no es especialmente útil para el usuario o el administrador del sistema que más adelante lee el registro de errores, mediante el visor de eventos win32. El registro de un error de E/S en todas las oportunidades posibles no es especialmente útil para los usuarios, por lo que un controlador de miniporte solo debe registrar errores críticos de E/S que pueden ayudar a un usuario o administrador del sistema a depurar un error de red para el que la NIC es responsable de un equipo determinado o de un conflicto de recursos de configuración detectado durante la inicialización del controlador.
En general, un controlador de miniporte llama a NdisWriteErrorLogEntry durante la inicialización desde su función MiniportInitializeEx si no puede inicializar una NIC que controla o no puede asignar los recursos de hardware que necesita para llevar a cabo operaciones de E/S en una NIC. Un controlador de minipuerto también puede llamar a NdisWriteErrorLogEntry cuando se produce un error en una operación de restablecimiento del dispositivo debido a errores de hardware irrecuperables. El registro de estos tipos de errores de E/S ayuda a los usuarios o administradores del sistema a identificar una NIC mal configurada o una NIC con componentes de hardware con errores.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con controladores NDIS 6.0 y NDIS 5.1 (consulte NdisWriteErrorLogEntry (NDIS 5.1)) en Windows Vista. Compatible con controladores NDIS 5.1 (consulte NdisWriteErrorLogEntry (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) |