Registrace síťového rozhraní

Při každém restartování počítače začne rozhraní NDIS prázdným seznamem registrovaných síťových rozhraní. Zprostředkovatel rozhraní volá funkci NdisIfRegisterInterface při každém spuštění nebo zjištění rozhraní, a pokud je známá jeho NET_LUID hodnota. Mechanismus pro spuštění nebo detekci rozhraní je specifický pro aplikaci.

NdisIfRegisterInterface vrátí NDIS_STATUS_SUCCESS pouze v případě, že NDIS úspěšně přidá zadané rozhraní do seznamu známých rozhraní v počítači. V tomto případě NdisIfRegisterInterface vrátí index rozhraní v parametru pIfIndex. Volání NdisIfRegisterInterface však neznamená, že rozhraní je aktivní; toto volání zaručuje pouze to, že rozhraní existuje. NdisIfRegisterInterface vrátí NDIS_STATUS_RESOURCES, pokud NDIS nemá k dispozici dostatek prostředků pro registraci rozhraní. NdisIfRegisterInterface může také vrátit další hodnoty stavu NDIS.

ProviderIfContext parametr NdisIfRegisterInterface obsahuje popisovač oblasti kontextu volajícího pro rozhraní — tento popisovač je předáván do dotazovacích a nastavovacích funkcí OID volajícího. Parametr pIfInfo obsahuje ukazatel na strukturu NET_IF_INFORMATION, která obsahuje informace o rozhraní.

Následující témata obsahují další informace o síťových rozhraních, která NdisIfRegisterInterface úspěšně zaregistruje:

Přidělení indexu rozhraní

informace o síťovém rozhraní