NdisRegisterInterface-Funktion (ndis.h)

Die NdisIfRegisterInterface-Funktion registriert eine NDIS-Netzwerkschnittstelle.

Syntax

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

Parameter

[in] NdisProviderHandle

Ein Handle, das den Netzwerkschnittstellenanbieter identifiziert, der die Schnittstelle registriert. Der Anrufer hat dieses Handle von einem vorherigen Aufruf an den NdisIfRegisterProvider Funktion.

[in] NetLuid

Der vom Aufrufer bereitgestellte NET_LUID Wert, der der Schnittstelle zugeordnet ist. Der Schnittstellenanbieter hat das NDIS_MAKE_NET_LUID Makro verwendet, um diesen NET_LUID Wert zu erstellen. Der Schnittstellenanbieter sollte den NET_LUID Wert nach dem Neustart des Computers wiederherstellen und bei jeder Registrierung einer bestimmten Schnittstelle den gleichen NET_LUID Wert bereitstellen.

[in] ProviderIfContext

Ein Handle für einen vom Aufrufer zugewiesenen Kontextbereich, der der Schnittstelle zugeordnet ist. NDIS übergibt dieses Handle an die Rückruffunktionen, die der Aufrufer bei NdisIfRegisterProviderregistriert hat.

[in] pIfInfo

Ein Zeiger auf eine vom Aufrufer zugewiesene NET_IF_INFORMATION Struktur, die Informationen zur Schnittstelle bereitstellt. Diese Struktur enthält Informationen, die konstant bleiben, während die Schnittstelle vorhanden ist.

pfIndex

Ein Zeiger auf eine vom Aufrufer bereitgestellte Schnittstellenindexvariable. Wenn NDIS erfolgreich eine Schnittstelle registriert, weist NDIS einen Schnittstellenindex für diese Schnittstelle zu und legt den Wert auf pIfIndex- fest. Der Schnittstellenindex ist ein 24-Bit-Wert, der auf dem lokalen Computer eindeutig ist. NDIS gibt möglicherweise nicht jedes Mal, wenn ein Anbieter eine Schnittstelle mit demselben NET_LUID Wert registriert, nicht denselben Schnittstellenindex zurück. Der Schnittstellenindexwert Null ist reserviert, und NDIS weist ihn keiner Schnittstelle zu. Verwechseln Sie den Schnittstellenindex nicht mit einem NET_LUID Index.

Rückgabewert

NdisIfRegisterInterface gibt einen der folgenden Statuswerte zurück:

Bemerkungen

NDIS-Schnittstellenanbieter rufen die NdisIfRegisterInterface--Funktion auf, um eine Netzwerkschnittstelle zu registrieren. Ein Aufruf dieser Funktion bedeutet nicht, dass die Schnittstelle aktiv ist.

Wenn ein Computer neu gestartet wird, beginnt NDIS mit einer leeren Liste der registrierten Netzwerkschnittstellen. Ein Schnittstellenanbieter ruft die NdisIfRegisterInterface--Funktion auf, wenn eine Schnittstelle gestartet (oder erkannt wird) und die Schnittstelle
NET_LUID ist bekannt.

Die Methode zum Erkennen oder Starten einer Schnittstelle ist anwendungsabhängig. Wenn beispielsweise ein LBFO MUX-Zwischentreiber ein Schnittstellenanbieter ist, registriert dieser Treiber möglicherweise eine interne Schnittstelle, wenn NDIS die ProtocolBindAdapterEx- funktion des Treibers für den ersten zugrunde liegenden Miniportadapter aufruft.

Ein Schnittstellenanbieter kann Informationen zu einer Schnittstelle im beständigen Speicher ablegen und die Schnittstelle nach Bedarf für die jeweilige Anwendung wiederherstellen. Beispielsweise kann der Anbieter zusätzliche Informationen über die Schnittstelle mit dem NET_LUID speichern und die Schnittstelle nach dem Neustart des Computers erneut registrieren.

Wenn NdisIfRegisterInter face erfolgreich ist, fügt NDIS die Schnittstelle zur Liste der bekannten Schnittstellen hinzu und weist einen neuen Schnittstellenindex für diese Schnittstelle zu. Schnittstellenanbieter sollten sowohl aktivierte als auch deaktivierte Schnittstellen registrieren, sofern möglich. Alle aktivierten Schnittstellen müssen registriert werden.

NDIS gibt möglicherweise nicht jedes Mal, wenn ein Anbieter eine Schnittstelle mit demselben NET_LUID Wert registriert, nicht denselben Schnittstellenindex zurück. Beispielsweise weist NDIS nicht unbedingt den gleichen Schnittstellenindex zu, wenn eine Schnittstelle nach einem Neustart eines Computers erneut registriert wird oder wenn die Schnittstelle registriert und erneut registriert wird. Der Schnittstellenindexwert Null ist reserviert, und NDIS weist ihn keiner Schnittstelle zu.

Um anzugeben, dass eine Schnittstelle aus der Liste der bekannten Schnittstellen auf dem Computer entfernt werden soll, ruft ein Schnittstellenanbieter die NdisDeregisterInterface Funktion, z. B. weil die Schnittstelle deinstalliert wurde. .

Anforderungen

Siehe auch

NDIS_MAKE_NET_LUID

NET_IF_INFORMATION

NET_LUID

NdisIfDeregisterInterface-

NdisIfRegisterProvider-

ProtocolBindAdapterEx-