NdisIfAddIfStackEntry function

The NdisIfAddIfStackEntry function specifies the ordering of two network interfaces in the NDIS network interface stack.

Syntax


NDIS_STATUS NdisIfAddIfStackEntry(
  _In_  NET_IFINDEX HigherLayerIfIndex,
  _In_  NET_IFINDEX LowerLayerIfIndex
);

Parameters

HigherLayerIfIndex [in]

The network interface index for the interface that should be higher in the interface stack table.

LowerLayerIfIndex [in]

The network interface index for the interface that should be lower in the interface stack table.

Return value

NdisIfAddIfStackEntry returns one of the following status values:

Return codeDescription
NDIS_STATUS_SUCCESS

The operation completed successfully.

NDIS_STATUS_RESOURCES

The operation failed because of insufficient resources.

NDIS_STATUS_INTERFACE_NOT_FOUND

NdisIfAddIfStackEntry failed because the index at HigherLayerIfIndex or LowerLayerIfIndex is not the index of a registered interface.

 

Remarks

NDIS drivers can call the NdisIfAddIfStackEntry function to specify the ordering of two network interfaces in the NDIS interface stack. The NDIS proxy provider specifies the order for filter modules and miniport adapters. NDIS also specifies the relationship between the virtual miniport and the underlying miniport adapter for filter intermediate drivers. However, NDIS does not specify the stack order for MUX intermediate drivers.

NDIS maintains an interface stack table (ifStackTable from RFC 2863). NDIS provides the NdisIfAddIfStackEntry and NdisIfDeleteIfStackEntry functions to add and delete entries in this table.

Any driver that can provide the information about the stack order relationship between two interfaces should call NdisIfAddIfStackEntry to populate the interface stack table. NDIS deletes the corresponding stack entries for an interface when the interface is deregistered.

Requirements

Version

Supported in NDIS 6.0 and later.

Header

Ndis.h (include Ndis.h)

IRQL

PASSIVE_LEVEL

DDI compliance rules

Irql_Interfaces_Function

See also

NdisIfDeleteIfStackEntry

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft