NDIS_SWITCH_DEREFERENCE_SWITCH_PORT Rückruffunktion (ndis.h)
Die DereferenceSwitchPort-Funktion dekrementiert den Referenzzähler des erweiterbaren Hyper-V-Switches für einen erweiterbaren Switchport. Der Verweiszähler wurde durch einen vorherigen Aufruf von ReferenceSwitchPort erhöht.
Syntax
NDIS_SWITCH_DEREFERENCE_SWITCH_PORT NdisSwitchDereferenceSwitchPort;
NDIS_STATUS NdisSwitchDereferenceSwitchPort(
[in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
[in] NDIS_SWITCH_PORT_ID SwitchPortId
)
{...}
Parameter
[in] NdisSwitchContext
Ein NDIS_SWITCH_CONTEXT Wert, der das Handle des erweiterbaren Switchmoduls enthält, an das die erweiterbare Hyper-V-Switcherweiterung angefügt ist. Wenn die Erweiterung NdisFGetOptionalSwitchHandlers aufruft, wird dieses Handle über den NdisSwitchContext-Parameter zurückgegeben.
[in] SwitchPortId
Ein NDIS_SWITCH_PORT_ID Wert, der den eindeutigen Bezeichner des erweiterbaren Switchports enthält, für den der erweiterbare Switchverweiszähler erhöht wird.
Rückgabewert
Wenn der Aufruf erfolgreich ist, gibt die Funktion NDIS_STATUS_SUCCESS zurück. Andernfalls wird ein NDIS_STATUS_Xxx-Fehlercode zurückgegeben, der in Ndis.h definiert ist.
Hinweise
Die erweiterbare Switcherweiterung ruft DereferenceSwitchPort auf, um den Verweiszähler für einen erweiterbaren Switchport zu dekrementieren. Während der Verweiszähler für den erweiterbaren Switch über einen Wert ungleich 0 (Null) verfügt, gibt der Protokollrand des erweiterbaren Switches keine OID-Set-Anforderung (Object Identifier) aus , die OID_SWITCH_PORT_DELETE , um den Port zu löschen.
Die Erweiterung muss DereferenceSwitchPort aufrufen, wenn sie zuvor ReferenceSwitchPort für einen erweiterbaren Switchport aufgerufen hatte.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt in NDIS 6.30 und höher. |
| Zielplattform | Desktop |
| Kopfzeile | ndis.h (include Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |
Weitere Informationen