NdisIfAddIfStackEntry (Compact 2013)
3/26/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 |