NDK_FN_LISTEN Rückruffunktion (ndkpi.h)

Die NdkListen- (NDK_FN_LISTEN) versetzt ein NDK-Listenerobjekt in den Überwachungsmodus.

Syntax

NDK_FN_LISTEN NdkFnListen;

NTSTATUS NdkFnListen(
  [in]           NDK_LISTENER *pNdkListener,
                 const PSOCKADDR pAddress,
  [in]           ULONG AddressLength,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parameter

[in] pNdkListener

Ein Zeiger auf ein NDK-Listenerobjekt (NDK_LISTENER).

pAddress

Eine lokale Adresse, die überwacht werden soll. Für AF_INET oder AF_INET6 pAddress- enthält die lokale IP-Adresse und den lokalen ND-Port.

[in] AddressLength

Die Größe der lokalen Adressdaten im pAddress-Parameter in Bytes.

[in] RequestCompletion

Ein Zeiger auf eine Anforderungsabschlussrückrufroutine NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

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

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Listenanforderung war erfolgreich.
STATUS_PENDING	Der Vorgang steht aus und wird später abgeschlossen. Der Treiber ruft die angegebene RequestCompletion (NDK_FN_REQUEST_COMPLETION) -Funktion auf, um den ausstehenden Vorgang abzuschließen.
STATUS_INSUFFICIENT_RESOURCES	Fehler bei der Anforderung aufgrund unzureichender Ressourcen. Wichtig Die Anforderung kann inline und asynchron mit diesem Statuscode fehlschlagen.
STATUS_SHARING_VIOLATION	Fehler bei der Anforderung, da die angegebene lokale Adresse bereits verwendet wird. Wichtig Die Anforderung kann inline und asynchron mit diesem Statuscode fehlschlagen.
STATUS_INVALID_ADDRESS	Fehler bei der Anforderung, da die angegebene lokale Adresse keine gültige Adresse für den Adapter ist. Wichtig Die Anforderung kann inline und asynchron mit diesem Statuscode fehlschlagen.
STATUS_TOO_MANY_ADDRESSES	Fehler bei der Anforderung, da der Consumer eine lokale Portnummer von Null angegeben hat, und der Netzwerk direct-Anbieter konnte keinen Port aus dem kurzlebigen Portraum (Ports 49152-65535) zuordnen.
Andere Statuscodes	Fehler.

Bemerkungen

NdkListen ein Listenerobjekt in den Überwachungsmodus der angegebenen lokalen Adresse versetzt.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Keine unterstützt,in NDIS 6.30 und höher unterstützt.
mindestens unterstützte Server-	Windows Server 2012
Zielplattform-	Fenster
Header-	ndkpi.h (include Ndkpi.h)
IRQL-	<=DISPATCH_LEVEL

Siehe auch

anforderungen für NDKPI-Objektlebensdauer

NDK_FN_REQUEST_COMPLETION

NDK_LISTENER