Función NdisWriteErrorLogEntry (ndis.h)

  • Artículo

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)

Consulte también

MiniportInitializeEx

MiniportResetEx

NdisMSetMiniportAttributes