ネットワーク インターフェイスの登録
コンピューターが再起動するたびに、NDIS は登録されたネットワーク インターフェイスの空の一覧で始まります。 インターフェイス プロバイダーは、インターフェイスを開始または検出し、その NET_LUID 値を認識するたびに NdisIfRegisterInterface 関数を呼び出します。 インターフェイスを開始または検出するメカニズムは、アプリケーションに固有です。
NdisIfRegisterInterface は、NDIS が指定されたインターフェイスをコンピューター上の既知のインターフェイスの一覧に正常に追加した場合のみ、NDIS_STATUS_SUCCESS を返します。 この場合、NdisIfRegisterInterface は pIfIndex パラメーターでインターフェイス インデックスを返します。 ただし、NdisIfRegisterInterface を呼び出しても、インターフェイスがアクティブであることを意味するわけではありません。この呼び出しでは、インターフェイスが存在することのみ保証されます。 NDISIfRegisterInterface は、インターフェイスを登録するための十分なリソースが NDIS にない場合に NDIS_STATUS_RESOURCES を返します。 NdisIfRegisterInterface は、他の NDIS ステータス値を返すこともできます。
NdisIfRegisterInterface の ProviderIfContext パラメーターには、インターフェイスの呼び出し元のコンテキスト領域へのハンドルが含まれています。このハンドルは、呼び出し元の OID クエリおよび設定関数に渡されます。 pIfInfo パラメーターには、インターフェイスに関する情報を含む NET_IF_INFORMATION 構造へのポインターが含まれています。
次のトピックでは、NdisIfRegisterInterface が正常に登録するネットワーク インターフェイスの詳細について説明します。