WriteErrorLog rule (ndis)

The WriteErrorLog rule specifies that if the NdisMAllocateSharedMemory function is called in the MiniportInitializeEx function, the driver should also call NdisWriteErrorLogEntry if the allocation fails.

Generally, it is a good practice to log an error entry in the log whenever an allocation memory operation fails. Most of the allocation operations occur in the MiniportInitializeEx callback function. See the following code example for more information about how to log an error.

Driver modelNDIS


// an example of how to log an error if memory allocation fails PVOID p;
NdisMAllocateSharedMemory(par1, par2, par3, &p, ...);
if (p == NULL)
 NdisWriteErrorLogEntry("Memory allocation failed");

How to test

At compile time

Run Static Driver Verifier and specify the WriteErrorLog rule.

Use the following steps to run an analysis of your code:
  1. Prepare your code (use role type declarations).
  2. Run Static Driver Verifier.
  3. View and analyze the results.

For more information, see Using Static Driver Verifier to Find Defects in Drivers.



Send comments about this topic to Microsoft