Freigeben über


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)

Weitere Informationen

IPSEC_OFFLOAD_V2_DELETE_SA

NDIS_IPSEC_OFFLOAD_V2_NET_BUFFER_LIST_INFO

NET_BUFFER_LIST