NDK_FN_LISTEN fonction de rappel (ndkpi.h)

  • Article

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