NdisIfQueryBindingIfIndex function (ndis.h)

Article
04/18/2022

The NdisIfQueryBindingIfIndex 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

[in] 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.

[out] 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.

[out] 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.

[out] pLowestIfIndex

[out] pLowestIfNetLuid

Return value

NdisIfQueryBindingIfIndex returns one of the following status values:

Return code	Description
NDIS_STATUS_SUCCESS	The operation completed successfully.
NDIS_STATUS_INTERFACE_NOT_FOUND	NdisIfQueryBindingIfIndex failed because the specified binding is not associated with a registered interface.

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

Requirement	Value
Minimum supported client	Supported in NDIS 6.0 and later.
Target Platform	Desktop
Header	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI compliance rules	Irql_Interfaces_Function(ndis)