Compartir a través de

Función NdisMCreateLog (ndis.h)

  • Artículo

NdisMCreateLog asigna y abre un archivo de registro en el que un controlador de miniporte puede escribir datos para que se muestren mediante una aplicación Win32 dedicada al controlador.

Sintaxis

NDIS_STATUS NdisMCreateLog(
  [in]  NDIS_HANDLE  MiniportAdapterHandle,
  [in]  UINT         Size,
  [out] PNDIS_HANDLE LogHandle
);

Parámetros

[in] MiniportAdapterHandle

Especifica la entrada de identificador en MiniportInitializeEx.

[in] Size

Especifica cuántos bytes se van a asignar para el archivo de registro. NDIS crea un archivo temporal que no se almacena en el disco.

[out] LogHandle

Puntero a una variable proporcionada por el autor de la llamada en la que esta función devuelve un identificador al archivo de registro. Este identificador es un parámetro necesario para las funciones NdisXxxLog a las que llama posteriormente el controlador de miniporte.

Valor devuelto

NdisMCreateLog puede devolver una de las siguientes opciones:

Código devuelto Descripción
NDIS_STATUS_SUCCESS
 El controlador de minipuerto puede usar el identificador devuelto en LogHandle para escribir datos en el archivo de registro asignado por NDIS.
NDIS_STATUS_RESOURCES
 No se pudo asignar un archivo de registro del tamaño especificado.
NDIS_STATUS_FAILURE
 El controlador ya llamado NdisMCreateLog correctamente.

Comentarios

Un controlador de minipuerto puede llamar a NdisM.. Funciones de registro para proporcionar cualquier información que elija el escritor de controladores. Sea cual sea el registro del controlador de miniporte, puede mostrarse mediante una aplicación Win32 dedicada al controlador. Esta aplicación llama a la función Win32 DeviceIoControl con IOCTL_NDIS_GET_LOG_DATA periódicamente para recuperar lo que el controlador de miniporte ha escrito en el archivo de registro. Por ejemplo, un controlador de minipuerto en desarrollo podría escribir datos de prueba que se mostrarán mediante su aplicación correspondiente.

Si NdisMCreateLog devuelve NDIS_STATUS_RESOURCES, el controlador puede ajustar el tamaño original hacia abajo e intentar llamar a esta función de nuevo. Sin embargo, un controlador de minipuerto no puede llamar a NdisMCreateLog para crear más de un archivo de registro después de que una llamada se realice correctamente.

Sea cual sea el tamaño del archivo de registro asignado, las llamadas posteriores a NdisMWriteLogData almacenan datos en este archivo, que se trata como un búfer circular. Es decir, una secuencia de llamadas a NdisMWriteLogData finalmente sobrescribe los datos escritos originalmente en el archivo de registro.

Requisitos

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

Consulte también

MiniportInitializeEx

NdisMCloseLog

NdisMFlushLog

NdisMWriteLogData