NdisReEnumerateProtocolBindings-Funktion (ndis.h)
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) |