NdisReEnumerateProtocolBindings-Funktion (ndis.h)
Die NdisReEnumerateProtocolBindings--Funktion bewirkt, dass NDIS die ProtocolBindAdapterEx- Funktion eines Protokolltreibers für jeden Miniportadapter, für den der Treiber für die Bindung konfiguriert ist, aber an den der Treiber derzeit nicht gebunden ist.
Syntax
void NdisReEnumerateProtocolBindings(
[in] NDIS_HANDLE NdisProtocolHandle
);
Parameter
[in] NdisProtocolHandle
Ein Handle, das den aufrufenden Protokolltreiber darstellt. Der Treiber hat dieses Handle mit einem vorherigen Aufruf des NdisRegisterProtocolDriver Funktion.
Rückgabewert
Nichts
Bemerkungen
Ein Protokolltreiber kann die NdisReEnumerateProtocolBindings--Funktion aufrufen, um eine erneute Verbindung mit einem oder mehreren Miniportadaptern durchzuführen.
Protokolltreiber können NdisReEnumerateProtocolBindings- nicht im Kontext des ProtocolBindAdapterEx-aufrufen oder
ProtocolUnbindAdapterEx--Funktionen. Darüber hinaus können Protokolltreiber NdisReEnumerateProtocolBindings- nicht im Kontext der ProtocolNetPnPEvent--Funktion aufrufen, wenn die
ProtocolBindingContext Parameter von ProtocolNetPnPEvent ist nicht NULL-. Protokolltreiber können jedoch NdisReEnumerateProtocolBindings aus dem Kontext ProtocolNetPnPEvent- aufrufen, wenn ProtocolBindingContext-NULL-ist. Ein NULL-ProtocolBindingContext- Wert gibt an, dass das Ereignis für alle Bindungen gilt.
NDIS kann die Bindungsvorgänge nach dem Aufruf von NdisReEnumerateProtocolBindings abschließen. Das heißt, NDIS kann Bindungen an die Miniportadapter abschließen, für die der Protokolltreiber für die Bindung konfiguriert ist, aber an den der Protokolltreiber zurzeit nicht zu einem späteren Zeitpunkt gebunden ist.
Ein Zwischentreiber sollte NdisReEnumerateProtocolBindings aufrufen, nachdem die ProtocolNetPnPEvent-Funktion-Funktion NetEventReconfigure für ein NULL-ProtocolBindingContext- empfängt. 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, aber an den der Treiber derzeit nicht gebunden ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte 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 |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | PASSIVE_LEVEL |
| DDI-Complianceregeln | Irql_Miscellaneous_Function(ndis), NdisReEnumerateProtocolBindings(ndis) |