NdisIMInitializeDeviceInstance

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

NdisIMInitializeDeviceInstancecalls an NDIS intermediate driver's MiniportInitializefunction to set up the driver's virtual network adapter for I/O operations on an underlying network adapter driver to which the intermediate driver is bound.

NDIS_STATUS
NdisIMInitializeDeviceInstance(
IN NDIS_HANDLE
DriverHandle, 
IN PNDIS_STRING
DeviceInstance
);

Parameters

DriverHandle

Specifies the handle returned by NdisIMRegisterLayeredMiniport.

DeviceInstance

Points to a buffered, caller-initialized counted string, in the system-default character set, naming the registry key in which the driver stores information about its virtual network adapter and, possibly, binding-specific information.

Return Values

NdisIMInitializeDeviceInstancepropagates the status returned by the MiniportInitializefunction.

Comments

An NDIS intermediate driver usually calls NdisIMInitializeDeviceInstancefrom its ProtocolBindAdapterfunction.

The driver's installation script created the key designated by DeviceInstancein the HKEY_LOCAL_MACHINE\System\CurrentControlSet\Servicesregistry tree.

Before it calls NdisIMInitializeDeviceInstance, ProtocolBindAdaptermust make a successful call to NdisOpenAdapter, thereby binding the intermediate driver to the underlying network adapter driver. Then, its subsequent call to NdisIMInitializeDeviceInstanceallows the driver's MiniportInitializefunction to allocate any resources the driver needs to carry out network I/O operations and to initialize the driver's virtual network adapter, to which higher-level protocol drivers can bind themselves when the NDIS intermediate driver's initialization is complete.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	3.0 and later	Ndis.h		Ndislib.lib

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.