Freigeben über

NDK_FN_LISTEN Rückruffunktion (ndkpi.h)

  • Artikel

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