NDK_FN_DISCONNECT Rückruffunktion (ndkpi.h)

Die Funktion NdkDisconnect (NDK_FN_DISCONNECT) startet eine Verbindung mit einer NDK-Verbindung.

Syntax

NDK_FN_DISCONNECT NdkFnDisconnect;

NTSTATUS NdkFnDisconnect(
  [in]           NDK_CONNECTOR *pNdkConnector,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parameter

[in] pNdkConnector

Ein Zeiger auf ein Connectorobjekt (NDK_CONNECTOR).

[in] RequestCompletion

Ein Zeiger auf eine Rückrufroutine für die Anforderungsvervollständigung NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Ein Kontextwert, der an den Context-Parameter der Rückruffunktion übergeben werden soll, der im RequestCompletion-Parameter angegeben ist.

Rückgabewert

Die NdkDisconnect-Funktion gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Verbindungsanforderung wurde erfolgreich abgeschlossen.
STATUS_PENDING	Der Vorgang steht aus und wird später abgeschlossen. Der Treiber ruft die angegebene RequestCompletion-Funktion (NDK_FN_REQUEST_COMPLETION) auf, um den ausstehenden Vorgang abzuschließen.
STATUS_IO_TIMEOUT	Für den Handshake zum Trennen wurde ein Timeout ausgeführt. Wichtig Die Anforderung kann sowohl inline als auch asynchron mit diesem status Code fehlschlagen.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

NdkDisconnect initiiert eine ordnungsgemäße Trennung für eine Verbindung. Nachdem der zugrunde liegende Protokolltreiber eine ordnungsgemäße Trennung ausgeführt hat, muss der NDK-Anbieter auch eine implizite Leerung des QP ausführen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Keine unterstützt, wird in NDIS 6.30 und höher unterstützt.
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Windows
Kopfzeile	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL

Weitere Informationen

Anforderungen an die Lebensdauer des NDKPI-Objekts

NDK_CONNECTOR_DISPATCH

NDK_FN_CONNECT

NDK_FN_REQUEST_COMPLETION