NDK_FN_LISTEN fonction de rappel (ndkpi.h)

Article
02/07/2025

La fonction NdkListen (NDK_FN_LISTEN) place un objet écouteur NDK en mode d’écoute.

Syntaxe

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
)
{...}

Paramètres

[in] pNdkListener

Pointeur vers un objet écouteur NDK (NDK_LISTENER).

pAddress

Adresse locale à écouter. Pour AF_INET ou AF_INET6 pAddress contient l’adresse IP locale et le port ND local.

[in] AddressLength

Taille, en octets, des données d’adresse locale au paramètre pAddress.

[in] RequestCompletion

Pointeur vers une routine de rappel de fin de requête NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Valeur de contexte à transmettre au paramètre Context de la fonction de rappel spécifiée dans le paramètre RequestCompletion.

Valeur de retour

La fonction NdkListen retourne l’un des codes NTSTATUS suivants.

Retourner le code	Description
STATUS_SUCCESS	La demande d’écoute a réussi.
STATUS_PENDING	L’opération est en attente et sera terminée ultérieurement. Le pilote appelle la fonction RequestCompletion (NDK_FN_REQUEST_COMPLETION) spécifiée pour terminer l’opération en attente.
STATUS_INSUFFICIENT_RESOURCES	La requête a échoué en raison de ressources insuffisantes. Important La requête peut échouer en ligne, ainsi que de manière asynchrone avec ce code d’état.
STATUS_SHARING_VIOLATION	La requête a échoué, car l’adresse locale spécifiée est déjà en cours d’utilisation. Important La requête peut échouer en ligne, ainsi que de manière asynchrone avec ce code d’état.
STATUS_INVALID_ADDRESS	La requête a échoué, car l’adresse locale spécifiée n’est pas une adresse valide pour l’adaptateur. Important La requête peut échouer en ligne, ainsi que de manière asynchrone avec ce code d’état.
STATUS_TOO_MANY_ADDRESSES	La requête a échoué, car le consommateur a spécifié un numéro de port local de zéro et le fournisseur Network Direct n’a pas pu allouer un port à partir de l’espace de port éphémère (ports 49152-65535.)
Autres codes d’état	Une erreur s’est produite.

Remarques

NdkListen place un objet écouteur en mode d’écoute sur l’adresse locale spécifiée.

Exigences

Exigence	Valeur
client minimum pris en charge	Aucune prise en charge, prise en charge dans NDIS 6.30 et versions ultérieures.
serveur minimum pris en charge	Windows Server 2012
plateforme cible	Windows
d’en-tête	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL

Voir aussi

exigences de durée de vie des objets NDKPI

NDK_FN_REQUEST_COMPLETION

NDK_LISTENER

Partager via