NDK_FN_LISTEN Rückruffunktion (ndkpi.h)

Artikel
02/26/2024

Die Funktion NdkListen (NDK_FN_LISTEN) versetzt ein NDK-Listenerobjekt in den Lauschmodus.

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 zum Lauschen. Für AF_INET oder AF_INET6 enthält pAddress die lokale IP-Adresse und den lokalen ND-Port.

[in] AddressLength

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

[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 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-Funktion (NDK_FN_REQUEST_COMPLETION) auf, um den ausstehenden Vorgang abzuschließen.
STATUS_INSUFFICIENT_RESOURCES	Fehler bei der Anforderung aufgrund unzureichender Ressourcen. Wichtig Die Anforderung kann sowohl inline als auch asynchron mit diesem status Code fehlschlagen.
STATUS_SHARING_VIOLATION	Fehler bei der Anforderung, da die angegebene lokale Adresse bereits verwendet wird. Wichtig Die Anforderung kann sowohl inline als auch asynchron mit diesem status Code fehlschlagen.
STATUS_INVALID_ADDRESS	Bei der Anforderung ist ein Fehler aufgetreten, da die angegebene lokale Adresse keine gültige Adresse für den Adapter ist. Wichtig Die Anforderung kann sowohl inline als auch asynchron mit diesem status Code fehlschlagen.
STATUS_TOO_MANY_ADDRESSES	Fehler bei der Anforderung, weil der Consumer eine lokale Portnummer von 0 angegeben hat und der Direkte Netzwerkanbieter keinen Port aus dem kurzlebigen Portraum zuordnen konnte (Ports 49152-65535).)
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

NdkListen versetzt ein Listenerobjekt in den Lauschmodus an der angegebenen lokalen Adresse.

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_FN_REQUEST_COMPLETION

NDK_LISTENER

Freigeben über