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 para 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 de NdisXxxLog que el controlador de miniporta llama posteriormente.
Valor devuelto
NdisMCreateLog puede devolver una de las siguientes opciones:
| Código devuelto | Descripción |
|---|---|
|
El controlador de miniport puede usar el identificador devuelto en logHandle para escribir datos en el archivo de registro asignado por NDIS. |
|
No se pudo asignar un archivo de registro del tamaño especificado. |
|
El controlador ya llamado NdisMCreateLog correctamente. |
Observaciones
Un controlador de minipuerto puede llamar al NdisM.. Registrar funciones para proporcionar cualquier información que elija el escritor de controladores. Independientemente de los registros del controlador de miniporte que pueda mostrar 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 haya escrito en el archivo de registro. Por ejemplo, un controlador de miniporte en desarrollo podría escribir datos de prueba que su aplicación correspondiente muestre.
Si NdisMCreateLog devuelve NDIS_STATUS_RESOURCES, el controlador puede ajustar el tamaño de original e intentar llamar a esta función de nuevo. Sin embargo, un controlador de miniport 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 almacenar 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 | Valor |
|---|---|
| cliente mínimo admitido | Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisMCreateLog (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisMCreateLog (NDIS 5.1)) en Windows XP. |
| de la plataforma de destino de | Universal |
| encabezado de | ndis.h (incluya Ndis.h) |
| biblioteca de | Ndis.lib |
| irQL | PASSIVE_LEVEL |
| reglas de cumplimiento de DDI | Irql_Miniport_Driver_Function(ndis) |