Registro de una interfaz de red
Cada vez que se reinicia un equipo, NDIS comienza con una lista vacía de interfaces de red registradas. Un proveedor de interfaz llama a la función NdisIfRegisterInterface cada vez que se inicia o detecta una interfaz y se conoce su valor de NET_LUID . El mecanismo para iniciar o detectar una interfaz es específico de la aplicación.
NdisIfRegisterInterface devuelve NDIS_STATUS_SUCCESS solo si NDIS agrega correctamente la interfaz especificada a su lista de interfaces conocidas en el equipo. En este caso, NdisIfRegisterInterface devuelve un índice de interfaz en el parámetro pIfIndex . Sin embargo, una llamada a NdisIfRegisterInterface no implica que la interfaz esté activa; esta llamada garantiza que solo existe la interfaz. NdisIfRegisterInterface devuelve NDIS_STATUS_RESOURCES si NDIS no tiene suficientes recursos disponibles para registrar la interfaz. NdisIfRegisterInterface también puede devolver otros valores de estado NDIS.
El parámetro ProviderIfContext de NdisIfRegisterInterface contiene un identificador para el área de contexto del autor de la llamada para la interfaz; este identificador se pasa a la consulta OID del autor de la llamada y establece las funciones. El parámetro pIfInfo contiene un puntero a una estructura NET_IF_INFORMATION que incluye información sobre la interfaz.
En los temas siguientes se proporciona más información sobre las interfaces de red que NdisIfRegisterInterface registra correctamente: