NDK_FN_LISTEN fonction de rappel (ndkpi.h)

Article
02/29/2024

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 sur laquelle é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 niveau du 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 à passer au paramètre Context de la fonction de rappel spécifiée dans le paramètre RequestCompletion .

Valeur retournée

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

Code de retour	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 demande a échoué en raison de ressources insuffisantes. Important La requête peut échouer en ligne et de manière asynchrone avec ce code status.
STATUS_SHARING_VIOLATION	La demande a échoué, car l’adresse locale spécifiée est déjà en cours d’utilisation. Important La requête peut échouer en ligne et de manière asynchrone avec ce code status.
STATUS_INVALID_ADDRESS	La demande 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 et de manière asynchrone avec ce code status.
STATUS_TOO_MANY_ADDRESSES	La demande a échoué, car le consommateur a spécifié un numéro de port local égal à 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 status	Une erreur est survenue.

Remarques

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucune prise en charge, prise en charge dans NDIS 6.30 et versions ultérieures.
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Windows
En-tête	ndkpi.h (incluez Ndkpi.h)
IRQL	<=DISPATCH_LEVEL

Voir aussi

Exigences relatives à la durée de vie des objets NDKPI

NDK_FN_REQUEST_COMPLETION

NDK_LISTENER

Partager via