NdisIfRegisterInterface 関数 (ndis.h)

[アーティクル]
08/07/2023

NdisIfRegisterInterface 関数は、NDIS ネットワークインターフェイスを登録します。

構文

NDIS_STATUS NdisIfRegisterInterface(
  [in] NDIS_HANDLE         NdisProviderHandle,
  [in] NET_LUID            NetLuid,
  [in] NDIS_HANDLE         ProviderIfContext,
  [in] PNET_IF_INFORMATION pIfInfo,
       PNET_IFINDEX        pfIndex
);

パラメーター

[in] NdisProviderHandle

インターフェイスを登録しているネットワークインターフェイスプロバイダーを識別するハンドル。呼び出し元は、への以前の呼び出しからこのハンドルを取得しました。 NdisIfRegisterProvider 関数。

[in] NetLuid

インターフェイスに関連付けられている呼び出し元が指定した NET_LUID 値。インターフェイスプロバイダーは、NDIS_MAKE_NET_LUID マクロを使用して、このNET_LUID値を作成しました。インターフェイスプロバイダーは、コンピューターの再起動後に永続ストレージからNET_LUID値を回復し、特定のインターフェイスを登録するたびに同じNET_LUID値を指定する必要があります。

[in] ProviderIfContext

インターフェイスに関連付けられている呼び出し元によって割り当てられたコンテキスト領域へのハンドル。 NDIS は、呼び出し元が NdisIfRegisterProvider に登録したコールバック関数にこのハンドルを渡します。

[in] pIfInfo

インターフェイスに関する情報を提供する呼び出し元によって割り当てられた NET_IF_INFORMATION 構造体へのポインター。この構造体には、インターフェイスが存在する間も一定の情報が含まれています。

pfIndex

呼び出し元が指定したインターフェイスインデックス変数へのポインター。 NDIS がインターフェイスを正常に登録した場合、NDIS はそのインターフェイスのインターフェイスインデックスを割り当て、 pIfIndex に値を設定します。インターフェイスインデックスは、ローカルコンピューターで一意の 24 ビット値です。プロバイダーが同じNET_LUID値を持つインターフェイスを登録するたびに、NDIS から同じインターフェイスインデックスが返されない場合があります。インターフェイスインデックス値 0 は予約済みであり、NDIS はインターフェイスに割り当てません。インターフェイスインデックスと NET_LUID インデックスを混同しないでください。

戻り値

NdisIfRegisterInterface は、次のいずれかの状態値を返します。

リターンコード	説明
NDIS_STATUS_SUCCESS	操作は正常に完了しました。
NDIS_STATUS_RESOURCES	リソースが不足しているため、操作が失敗しました。
NDIS_STATUS_INVALID_PARAMETER	入力パラメーターの一部が無効であるため、NdisIfRegisterInterface が失敗しました。
NDIS_STATUS_DUPLICATE_OBJECTID	NetLuid パラメーターが指定したのと同じNET_LUID値を持つインターフェイスが既に登録されているため、NdisIfRegisterInterface が失敗しました。

注釈

NDIS インターフェイスプロバイダーは、ネットワークインターフェイスを登録するために NdisIfRegisterInterface 関数を呼び出します。この関数の呼び出しは、インターフェイスがアクティブであることを意味するものではありません。

コンピューターが再起動するたびに、NDIS は登録済みのネットワークインターフェイスの空の一覧で始まります。インターフェイスプロバイダーは、インターフェイスが開始 (または検出) されるたびに NdisIfRegisterInterface 関数を呼び出します。
NET_LUID は既知です。

インターフェイスを検出または開始する方法は、アプリケーションによって異なります。たとえば、LBFO MUX 中間ドライバーがインターフェイスプロバイダーである場合、NDIS が最初の基になるミニポートアダプターのドライバーの ProtocolBindAdapterEx 関数を呼び出すときに、そのドライバーが内部インターフェイスを登録する可能性があります。

インターフェイスプロバイダーは、永続的ストレージにインターフェイスに関する情報を格納し、特定のアプリケーションに必要に応じてインターフェイスを復元できます。たとえば、プロバイダーは、 NET_LUID を使用してインターフェイスに関する追加情報を格納し、コンピューターの再起動後にインターフェイスを再登録できます。

NdisIfRegisterInterface が成功した場合、NDIS は、既知のインターフェイスの一覧にインターフェイスを追加し、このインターフェイスの新しいインターフェイスインデックスを割り当てます。インターフェイスプロバイダーは、可能な限り、有効なインターフェイスと無効なインターフェイスの両方を登録する必要があります。すべての有効なインターフェイスを登録する必要があります。

プロバイダーが同じNET_LUID値を持つインターフェイスを登録するたびに、NDIS は同じインターフェイスインデックスを返さない場合があります。たとえば、コンピューターの再起動後にインターフェイスが再登録されたとき、またはインターフェイスが登録解除されて再登録された場合、NDIS は必ずしも同じインターフェイスインデックスを割り当てるわけではありません。インターフェイスインデックス値 0 は予約済みであり、NDIS はインターフェイスに割り当てません。

コンピューター上の既知のインターフェイスの一覧からインターフェイスを削除する必要があることを示すために、インターフェイスプロバイダーはを呼び出します。たとえば、インターフェイスがアンインストールされているため、NdisIfDeregisterInterface 関数。 .

要件

要件	値
サポートされている最小のクライアント	NDIS 6.0 以降でサポートされています。
対象プラットフォーム	デスクトップ
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	Irql_Interfaces_Function(ndis)