NdisIMGetBindingContext

Windows CE .NET

This function 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.

NDIS_HANDLE NdisIMGetBindingContext(
  NDIS_HANDLE NdisBindingHandle
);

Parameters

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

Return Values

The following table shows the return values for NdisIMGetBindingContext.

Value Description
NDISIMGETBINDINGCONTEXT Returns access to the device context area for the given virtual NIC.
NULL Returns if no device context area exists for the given virtual NIC.

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 should treat the returned context area as read-only, preserving the state set up by the underlying NDIS intermediate driver that defined it.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Ndis.h.

See Also

NdisOpenAdapter | MiniportInitialize | ProtocolBindAdapter | NdisIMInitializeDeviceInstanceEx | NdisIMGetDeviceContext


 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.

Show: