Share via

NdisIfAddIfStackEntry (Compact 7)

  • Article

3/12/2014

This 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
    The network interface index for the interface that should be higher in the interface stack table.
  • LowerLayerIfIndex
    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:

Value Description

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

Header

ndis.h

See Also

Reference

NDIS Network Interface Functions
NdisIfDeleteIfStackEntry