NDK_FN_CREATE_LISTENER fonction de rappel (ndkpi.h)

Article
03/05/2024

La fonction NdkCreateListener (NDK_FN_CREATE_LISTENER) crée un objet écouteur NDK.

Syntaxe

NDK_FN_CREATE_LISTENER NdkFnCreateListener;

NTSTATUS NdkFnCreateListener(
  [in]           NDK_ADAPTER *pNdkAdapter,
  [in]           NDK_FN_CONNECT_EVENT_CALLBACK ConnectEvent,
  [in, optional] PVOID ConnectEventContext,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_LISTENER **ppNdkListener
)
{...}

Paramètres

[in] pNdkAdapter

Pointeur vers un objet d’adaptateur NDK (NDK_ADAPTER).

[in] ConnectEvent

Pointeur vers la fonction NdkConnectEventCallback (NDK_FN_CONNECT_EVENT_CALLBACK) que le fournisseur utilise pour notifier le consommateur pour chaque demande de connexion entrante.

[in, optional] ConnectEventContext

Valeur de contexte que le fournisseur NDK transmet à la fonction NdkConnectEventCallback spécifiée dans le paramètre ConnectEvent .

[in] CreateCompletion

Pointeur vers une fonction NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) qui termine la création d’un objet NDK.

[in, optional] RequestContext

Valeur de contexte que le fournisseur NDK transmet à la fonction NdkCreateCompletion spécifiée dans le paramètre CreateCompletion .

ppNdkListener

Un pointeur vers l’objet d’écouteur NDK (NDK_LISTENER) créé est retourné à cet emplacement si la demande réussit sans retourner STATUS_PENDING. Si NdkCreateListener retourne STATUS_PENDING ce paramètre est ignoré et l’objet créé est retourné avec le rappel spécifié dans le paramètre CreateCompletion .

Valeur retournée

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

Code de retour	Description
STATUS_SUCCESS	L’objet écouteur a été créé avec succès et retourné avec le paramètre *ppNdkListener .
STATUS_PENDING	L’opération est en attente et sera terminée ultérieurement. Le fournisseur appelle la fonction spécifiée dans le paramètre CreateCompletion (NDK_FN_CREATE_COMPLETION) pour terminer l’opération en attente.
STATUS_INSUFFICIENT_RESOURCES	La demande a échoué en raison de ressources insuffisantes. Important La demande peut échouer en ligne et de manière asynchrone avec ce code status.
Autres codes status	Une erreur est survenue.

Remarques

La fonction NdkCreateListener crée un objet d’écouteur NDK. Si la fonction retourne STATUS_SUCCESS, l’objet créé est retourné dans le paramètre ppNdkListener . Si NdkCreateListener retourne STATUS_PENDING, l’objet créé est retourné par la fonction NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) spécifiée dans le paramètre CreateCompletion .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge, pris 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 (inclure Ndkpi.h)
IRQL	<=DISPATCH_LEVEL