Función NdisMCreateLog (ndis.h)

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:

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

Consulte también

MiniportInitializeEx

NdisMCloseLog

NdisMFlushLog

NdisMWriteLogData