NdisReEnumerateProtocolBindings-Funktion (ndis.h)

Artikel
03/01/2024

Die NdisReEnumerateProtocolBindings-Funktion bewirkt, dass NDIS die ProtocolBindAdapterEx-Funktion eines Protokolltreibers einmal für jeden Miniportadapter aufruft, für den der Treiber für die Bindung konfiguriert ist, an den der Treiber derzeit aber nicht gebunden ist.

Syntax

void NdisReEnumerateProtocolBindings(
  [in] NDIS_HANDLE NdisProtocolHandle
);

Parameter

[in] NdisProtocolHandle

Ein Handle, der den aufrufenden Protokolltreiber darstellt. Der Treiber hat dieses Handle mit einem vorherigen Aufruf des NdisRegisterProtocolDriver-Funktion .

Rückgabewert

Keine

Bemerkungen

Ein Protokolltreiber kann die NdisReEnumerateProtocolBindings-Funktion aufrufen, um an einen oder mehrere Miniportadapter neu zu binden.

Protokolltreiber können NdisReEnumerateProtocolBindings nicht aus dem Kontext des ProtocolBindAdapterEx aufrufen, oder ProtocolUnbindAdapterEx-Funktionen . Außerdem können Protokolltreiber NdisReEnumerateProtocolBindings im Kontext der ProtocolNetPnPEvent-Funktion nicht aufrufen, wenn
ProtocolBindingContext-Parameter von ProtocolNetPnPEvent ist nicht NULL. Protokolltreiber können jedoch NdisReEnumerateProtocolBindings aus dem Kontext von ProtocolNetPnPEvent aufrufen, wenn ProtocolBindingContextNULL ist. Ein NULLProtocolBindingContext-Wert gibt an, dass das Ereignis für alle Bindungen gilt.

NDIS kann die Bindungsvorgänge abschließen, nachdem der Aufruf von NdisReEnumerateProtocolBindings zurückgegeben wurde. Das heißt, NDIS schließt möglicherweise Bindungen an die Miniportadapter ab, für die der Protokolltreiber für die Bindung konfiguriert ist, an die der Protokolltreiber jedoch zu einem späteren Zeitpunkt nicht gebunden ist.

Ein Zwischentreiber sollte NdisReEnumerateProtocolBindings aufrufen, nachdem seine ProtocolNetPnPEvent-FunktionNetEventReconfigure für ein NULLProtocolBindingContext empfangen hat. NDIS ruft dann die ProtocolBindAdapterEx-Funktion des Treibers einmal für jeden Miniportadapter auf, für den der Treiber für die Bindung konfiguriert ist, an den der Treiber derzeit aber nicht gebunden ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisReEnumerateProtocolBindings (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisReEnumerateProtocolBindings (NDIS 5.1)) in Windows XP.
Zielplattform	Desktop
Kopfzeile	ndis.h (einschließlich Ndis.h)
Bibliothek	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_Miscellaneous_Function(ndis), NdisReEnumerateProtocolBindings(ndis)