NdisMInitializeWrapper

NdisMInitializeWrapper

VOID
   NdisMInitializeWrapper(
       OUT PNDIS_HANDLE NdisWrapperHandle,
       IN PVOID SystemSpecific1,
       IN PVOID SystemSpecific2,
       IN PVOID SystemSpecific3
       );

NdisMInitializeWrapper notifies NDIS that a new miniport is initializing.

Parameters

NdisWrapperHandle

Points to a caller-supplied variable in which NDIS returns a handle that represents itself.

SystemSpecific1

Specifies a pointer of a system-specific type.

For Windows NT drivers, this is a pointer to an opaque driver object input to the miniport’s DriverEntry function.

SystemSpecific2

Specifies a pointer of a system-specific type.

For Windows NT drivers, this is a pointer to an opaque registry path input to the miniport’s DriverEntry function.

SystemSpecific3

Specifies a pointer of a system-specific type.

For Windows NT drivers, this pointer should be set to NULL when the miniport calls NdisMInitializeWrapper.

Comments

A NIC driver or intermediate driver must call NdisMInitializeWrapper before it calls any other NdisXxx function. Usually, this call is the initial action of any NIC driver’s DriverEntry function, which calls NdisMRegisterMiniport or NdisIMRegisterLayeredMiniport with the returned NdisWrapperHandle next. NDIS intermediate drivers also must call NdisMIntializeWrapper from the DriverEntry function and, then, call NdisMRegisterMiniport or NdisIMRegisterLayeredMiniport with the returned NdisWrapperHandle.

Such a driver’s subsequent calls to NdisXxx initialization and configuration functions must pass the NdisWrapperHandle as a parameter. Consequently, it is an input parameter to the MiniportInitialize function.

Callers of NdisMInitializeWrapper run at IRQL PASSIVE_LEVEL.