NDK_FN_ACCEPT_EX fonction de rappel (ndkpi.h)

Article
02/07/2025

La fonction NdkAcceptEx (NDK_FN_ACCEPT_EX) accepte une demande de connexion entrante sur un objet écouteur.

Syntaxe

NDK_FN_ACCEPT_EX NdkFnAcceptEx;

NTSTATUS NdkFnAcceptEx(
  [in]                                      NDK_CONNECTOR *pNdkConnector,
  [in]                                      NDK_QP *pNdkQp,
  [in]                                      ULONG InboundReadLimit,
  [in]                                      ULONG OutboundReadLimit,
  [_In_reads_bytes_opt_(PrivateDataLength)] const PVOID pPrivateData,
  [in]                                      ULONG PrivateDataLength,
  [in, optional]                            NDK_FN_DISCONNECT_EVENT_CALLBACK_EX DisconnectEvent,
  [in, optional]                            PVOID DisconnectEventContext,
  [in]                                      NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional]                            PVOID RequestContext
)
{...}

Paramètres

[in] pNdkConnector

Pointeur vers un objet connecteur NDK (NDK_CONNECTOR).

[in] pNdkQp

Pointeur vers un objet de paire de files d’attente NDK (QP) (NDK_QP) à associer à la connexion.

[in] InboundReadLimit

Nombre maximal d’opérations de lecture entrantes en cours fournies par le consommateur pour permettre le QP. Si le fournisseur sous-jacent a une valeur inférieure MaxInboundReadLimit dans la structure NDK_ADAPTER_INFO, le fournisseur limite la valeur fournie par le consommateur au maximum du fournisseur. Si l’homologue a une valeur inférieure OutboundReadLimit, le fournisseur utilise cette valeur comme valeur effective InboundReadLimit. Le consommateur peut récupérer le inboundReadLimit effectif en appelant la fonction NdkGetConnectionData (NDK_FN_GET_CONNECTION_DATA).

[in] OutboundReadLimit

Nombre maximal d’opérations de lecture sortantes en cours fournies par le consommateur pour permettre le QP. Si le fournisseur sous-jacent a une valeur inférieure MaxOutboundReadLimit dans la structure NDK_ADAPTER_INFO, le fournisseur limite la valeur fournie par le consommateur au maximum du fournisseur. Si l’homologue a une inférieureInboundReadLimit, le fournisseur utilise cette valeur comme effectiveOutboundReadLimit. Le consommateur peut récupérer la OutboundReadLimit effective en appelant la fonction NdkGetConnectionData (NDK_FN_GET_CONNECTION_DATA).

[_In_reads_bytes_opt_(PrivateDataLength)] pPrivateData

Données privées renvoyées avec la demande d’acceptation.

[in] PrivateDataLength

Longueur, en octets, des données privées fournies dans le paramètre pPrivateData.

[in, optional] DisconnectEvent

Point d’entrée pour une fonction de rappel de notification de déconnexion facultative NdkDisconnectEventCallbackEx NDK_FN_DISCONNECT_EVENT_CALLBACK_EX. Le fournisseur appelle cette fonction de rappel lorsque l’homologue se déconnecte.

[in, optional] DisconnectEventContext

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

[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 NDK_FN_ACCEPT_EX retourne l’un des codes NTSTATUS suivants.

Retourner le code	Description
STATUS_SUCCESS	L’opération s’est terminée avec succès.
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_CONNECTION_ABORTED	L’homologue de connexion a abandonné l’établissement de connexion en attente.
STATUS_IO_TIMEOUT	L’homologue n’a pas appelé la fonction CompleteConnect (NDK_FN_COMPLETE_CONNECT_EX) pour terminer la demande de connexion en attente.
Autres codes d’état	Une erreur s’est produite.

Remarques

Le consommateur NDK appelle NdkAcceptEx pour accepter une demande de connexion entrante sur un objet écouteur.

La fonction NdkCreateListener (NDK_FN_CREATE_LISTENER) crée un objet écouteur NDK et fournit une fonction NdkConnectEventCallback (NDK_FN_CONNECT_EVENT_CALLBACK).

La fonction NdkConnectEventCallback est utilisée par le fournisseur NDK pour informer le consommateur de chaque demande de connexion entrante.

Exigences

Exigence	Valeur
client minimum pris en charge	Pris en charge dans NDKPI 2.1 et versions ultérieures.
serveur minimum pris en charge	Windows Server 2022
plateforme cible	Windows
d’en-tête	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL