XXX_Init (NDIS) (Windows Embedded CE 6.0)

1/6/2010

When an NDIS Protocol Driver is loaded, either during initialization or through a device call, the driver-supplied function xxx_Init (Services.exe) is called.

Syntax

DWORD XXX_Init(
  DWORD dwContext
);

Parameters

• dwContext
  [in] Pointer to a string containing the registry path to the active key for the stream interface driver.

Return Value

Returns a handle to the device context created, or 0 if unsuccessful.

Remarks

The XXX_Init function of every type of NDIS protocol driver must call NdisRegisterProtocol to register the driver's ProtocolXxx entry points with the NDIS library. All types of NDIS protocols should register fully functional ProtocolBindAdapter and ProtocolUnbindAdapter functions to support plug and play. In general, a XXX_Init function should call NdisRegisterProtocol just before it.

If an attempt to allocate resources that the driver needs to carry out network I/O operations fails, XXX_Init should release all resources it already allocated before it returns 0.

Requirements

See Also

Reference

NDIS Lower-Edge Functions
ActivateDevice
RegisterDevice
MiniportInitialize
NdisIMRegisterLayeredMiniport
NdisMInitializeWrapper
NdisRegisterProtocol
ProtocolBindAdapter
ProtocolUnbindAdapter

Other Resources

xxx_Init (Services.exe)