NdisIMGetBindingContext (NDIS 5.1) function

Article
06/19/2017

Note NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.

NdisIMGetBindingContext allows an NDIS protocol to access the device context area, created by an underlying intermediate driver, for a virtual NIC to which the higher level protocol is bound.

Syntax

NDIS_HANDLE NdisIMGetBindingContext(
  _In_ NDIS_HANDLE NdisBindingHandle
);

Parameters

NdisBindingHandle [in]
Specifies the handle returned by NdisOpenAdapter that identifies the virtual NIC of the next lower intermediate driver to which the caller is bound.

Return value

NdisIMGetBindingContext returns access to the device context area for the given virtual NIC, or it returns NULL if no such context area exists.

Remarks

A highest level NDIS protocol driver or intermediate protocol can call NdisIMGetBindingContext from its ProtocolBindAdapter function to access the device context for a virtual NIC to which it is bound. The device context provides a common context area for all higher level protocols bound to the same underlying intermediate driver.

Such a device context area was allocated and defined by the lower level NDIS intermediate driver and passed to NDIS in a call to NdisIMInitializeDeviceInstanceEx. This intermediate driver's MiniportInitialize function calls NdisIMGetDeviceContext to gain access this device context area if it was allocated by the intermediate driver's ProtocolBindAdapter function.

All protocols that call NdisIMGetBindingContext can safely assume that the underlying intermediate driver allocated its context area from nonpaged pool. They should treat the returned context area as read-only, preserving the state set up by the underlying NDIS intermediate driver that defined it.

Requirements

Target platform	Universal
Version	See NdisIMGetBindingContext.
Header	Ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL	< DISPATCH_LEVEL