NdisIfQueryBindingIfIndex (Compact 7)

3/12/2014

This function retrieves the network interface indexes and NET_LUID values for the highest and lowest layered network interfaces that are associated with a specified protocol binding.

Syntax

NDIS_STATUS
  NdisIfQueryBindingIfIndex(
    IN NDIS_HANDLE  NdisBindingHandle,
    OUT PNET_IFINDEX  pBoundIfIndex,
    OUT PNET_LUID  pBoundIfNetLuid,
    OUT PNET_IFINDEX  pLowestIfIndex,
    OUT PNET_LUID  pLowestIfNetLuid
    );

Parameters

• NdisBindingHandle
  A handle that identifies the binding for which NDIS should obtain the NET_LUID values and network interface indexes. NDIS provided this handle at the NdisBindingHandle parameter of the NdisOpenAdapterEx function.

• pBoundIfIndex
  A pointer to a caller-supplied interface index variable. If NdisIfQueryBindingIfIndex succeeds, NDIS writes to this variable the network interface index of the network interface that is associated with the specified binding and is highest in the driver stack.

• pBoundIfNetLuid
  A pointer to a caller-supplied NET_LUID variable. If NdisIfQueryBindingIfIndex succeeds, NDIS writes to this variable the NET_LUID value of the network interface that is associated with the specified binding and is highest in the driver stack.

• pLowestIfIndex
  A pointer to a caller-supplied interface index variable. If NdisIfQueryBindingIfIndex succeeds, NDIS writes to this variable the network interface index of the network interface that is associated with the specified binding and is lowest in the driver stack.

• pLowestIfNetLuid
  A pointer to a caller-supplied NET_LUID variable. If NdisIfQueryBindingIfIndex succeeds, NDIS writes to this variable the NET_LUID value of the network interface that is associated with the specified binding and is lowest in the driver stack.

Return Value

NdisIfQueryBindingIfIndex returns one of the following status values:

Remarks

NDIS protocol drivers can call the NdisIfQueryBindingIfIndex function to retrieve the network interface indexes and NET_LUID values that are associated with a binding.

NdisIfQueryBindingIfIndex provides the NET_LUID value and the interface index for the highest interface and lowest interface that are associated with the binding. These values are different, for example, if the miniport adapter that is directly associated with the specified binding is the virtual miniport of a filter intermediate driver or if there is a filter module that is configured over the miniport adapter.

Protocol drivers can also obtain the interface index and NET_LUID of the highest and the lowest interfaces in a driver stack in the NDIS_BIND_PARAMETERS structure.

Requirements

See Also

Reference

NDIS Network Interface Functions
NDIS_BIND_PARAMETERS
NdisOpenAdapterEx

Other Resources

NET_LUID