OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA
[Das IPsec-Aufgabenauslagerungsfeature ist veraltet und sollte nicht verwendet werden.]
Als Satz verwendet der TCP/IP-Transport die OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID, um anzufordern, dass ein Miniporttreiber die angegebenen Sicherheitszuordnungen (Security Associations, SAs) aus einer NIC löscht.
Hinweis NDIS unterstützt diese OID mit der direkten OID-Anforderungsschnittstelle. Weitere Informationen zur direkten OID-Anforderungsschnittstelle finden Sie unter NDIS 6.1 Direct OID Request Interface.
Bemerkungen
Alle NDIS 6.1-Miniporttreiber, die IPsec Offload Version 2 (IPsecOV2) unterstützen, müssen diese OID unterstützen.
Wenn ein Miniporttreiber diese Anforderung empfängt, sollte der Treiber die angegebenen SAs aus der NIC löschen und alle Systemressourcen freigeben, die für die SAs zugewiesen wurden.
Der Miniporttreiber empfängt eine IPSEC_OFFLOAD_V2_DELETE_SA-Struktur , die ein Handle zu einem SA-Bündel und einen Zeiger auf die nächste IPSEC_OFFLOAD_V2_DELETE_SA-Struktur in einer verknüpften Liste enthält.
Der Miniporttreiber kann SaDeleteReq in der NDIS_IPSEC_OFFLOAD_V2_NET_BUFFER_LIST_INFO-Struktur für eine Empfangs-NET_BUFFER_LIST-Struktur festlegen. Der TCP/IP-Transport gibt anschließend OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA einmal aus, um die eingehende SA zu löschen, über die das Paket empfangen wurde, und erneut, um die ausgehende SA zu löschen, die der gelöschten eingehenden SA entspricht. Die Netzwerkkarte darf keine dieser SAs entfernen, bevor die entsprechende OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA-Anforderung empfangen wird.
Zurückgeben von status Codes
Die MiniportOidRequest-Funktion des Miniport-Treibers gibt einen der folgenden Werte für diese Anforderung zurück:
| Begriff | BESCHREIBUNG |
|---|---|
NDIS_STATUS_SUCCESS |
Der Miniporttreiber hat die Anforderung erfolgreich abgeschlossen. |
NDIS_STATUS_PENDING |
Der Miniporttreiber führt die Anforderung asynchron aus. Nachdem der Miniporttreiber alle Verarbeitungsschritte abgeschlossen hat, muss er die Anforderung erfolgreich ausführen, indem er die NdisMOidRequestComplete-Funktion aufruft und NDIS_STATUS_SUCCESS für den Parameter Status übergibt. |
NDIS_STATUS_NOT_ACCEPTED |
Der Miniporttreiber wird zurückgesetzt. |
NDIS_STATUS_REQUEST_ABORTED |
Der Miniporttreiber hat die Verarbeitung der Anforderung beendet. Beispielsweise hat NDIS die MiniportResetEx-Funktion aufgerufen. |
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.1 und höher. |
Header |
Ntddndis.h (include Ndis.h) |