NdisIfGetInterfaceIndexFromNetLuid (Compact 2013)
3/26/2014
This function gets the network interface index that is associated with a NET_LUID value.
Syntax
NDIS_STATUS
NdisIfGetInterfaceIndexFromNetLuid(
IN NET_LUID NetLuid,
OUT PNET_IFINDEX pIfIndex
);
Parameters
- NetLuid
A NET_LUID value that identifies a network interface.
- pIfIndex
A pointer to a caller-supplied interface index variable. If NdisIfGetInterfaceIndexFromNetLuid succeeds, NDIS writes the network interface index that is associated with the specified NET_LUID to this variable.
Return Value
NdisIfGetInterfaceIndexFromNetLuid returns one of the following status values:
Value |
Description |
|---|---|
NDIS_STATUS_SUCCESS |
The operation completed successfully. |
NDIS_STATUS_INTERFACE_NOT_FOUND |
NdisIfGetInterfaceIndexFromNetLuid failed because the specified NET_LUID was not present in the list of registered interfaces. |
Remarks
NDIS drivers can call the NdisIfGetInterfaceIndexFromNetLuid function to obtain the network interface index that is associated with a NET_LUID value.
For the interfaces that the NDIS proxy provider service manages, NDIS provides the interface index and NET_LUID in various driver initialization structures:
- Miniport drivers can obtain the interface index and NET_LUID for a miniport adapter in the NDIS_MINIPORT_INIT_PARAMETERS structure.
- Filter drivers can obtain the interface index and NET_LUID for a filter module in the NDIS_FILTER_ATTACH_PARAMETERS structure.
- Protocol drivers can obtain the interface index and NET_LUID of the highest and the lowest interfaces on a driver stack in the NDIS_BIND_PARAMETERS structure.
NDIS assigns an interface index to a network interface when the interface provider calls the NdisIfRegisterInterface function. An interface provider calls the NDIS_MAKE_NET_LUID macro to create the NET_LUID value before it registers an interface.
The interface index value can change without a device restart. Deregistering and reregistering an interface that is associated with a NET_LUID value might result in different interface index values. Do not confuse the interface index with the NET_LUID index that persists after a device restarts.
NDIS provides the NdisIfGetNetLuidFromInterfaceIndex function to obtain the NET_LUID value that is associated with a specified interface index.
Requirements
Header |
ndis.h |
See Also
Reference
NDIS Network Interface Functions
NDIS_BIND_PARAMETERS
NDIS_FILTER_ATTACH_PARAMETERS
NDIS_MAKE_NET_LUID
NDIS_MINIPORT_INIT_PARAMETERS
NdisIfGetNetLuidFromInterfaceIndex
NdisIfRegisterInterface