Registrazione di un'interfaccia di rete
Ogni volta che un computer viene riavviato, NDIS inizia con un elenco vuoto di interfacce di rete registrate. Un provider di interfaccia chiama la funzione NdisIfRegisterInterface ogni volta che viene avviata o rileva un'interfaccia e il relativo valore NET_LUID è noto. Il meccanismo per avviare o rilevare un'interfaccia è specifica dell'applicazione.
NdisIfRegisterInterface restituisce NDIS_STATUS_SUCCESS solo se NDIS aggiunge correttamente l'interfaccia specificata all'elenco di interfacce note nel computer. In questo caso , NdisIfRegisterInterface restituisce un indice di interfaccia al parametro pIfIndex . Tuttavia, una chiamata a NdisIfRegisterInterface non implica che l'interfaccia sia attiva; questa chiamata garantisce solo che l'interfaccia esista. NdisIfRegisterInterface restituisce NDIS_STATUS_RESOURCES se NDIS non dispone di risorse sufficienti per registrare l'interfaccia. NdisIfRegisterInterface può restituire anche altri valori di stato NDIS.
Il parametro ProviderIfContext di NdisIfRegisterInterface contiene un handle per l'area di contesto del chiamante per l'interfaccia- questo handle viene passato alla query OID del chiamante e alle funzioni impostate. Il parametro pIfInfo contiene un puntatore a una struttura NET_IF_INFORMATION che include informazioni sull'interfaccia.
Gli argomenti seguenti forniscono altre informazioni sulle interfacce di rete registrate correttamente da NdisIfRegisterInterface :