NDK_FN_ACCEPT_EX fonction de rappel (ndkpi.h)
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 (QP) NDK (NDK_QP) à associer à la connexion.
[in] InboundReadLimit
Nombre maximal d’opérations de lecture entrantes en cours fournies par le consommateur à autoriser sur le QP. Si le fournisseur sous-jacent a une valeur MaxInboundReadLimit inférieure dans la structure NDK_ADAPTER_INFO , le fournisseur limite la valeur fournie par le consommateur à la valeur maximale du fournisseur. Si l’homologue a une valeur OutboundReadLimit inférieure, le fournisseur utilise cette valeur comme inboundReadLimit effectif. Le consommateur peut récupérer la propriété InboundReadLimit effective 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 à autoriser sur le QP. Si le fournisseur sous-jacent a une valeur MaxOutboundReadLimit inférieure dans la structure NDK_ADAPTER_INFO , le fournisseur limite la valeur fournie par le consommateur à la valeur maximale du fournisseur. Si l’homologue a un inboundReadLimit inférieur, le fournisseur utilise cette valeur comme OutboundReadLimit effectif. Le consommateur peut récupérer le OutboundReadLimit effectif en appelant la fonction NdkGetConnectionData (NDK_FN_GET_CONNECTION_DATA).
[_In_reads_bytes_opt_(PrivateDataLength)] pPrivateData
Données privées qui sont 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 à passer 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 à passer au paramètre Context de la fonction de rappel spécifiée dans le paramètre RequestCompletion .
Valeur retournée
La fonction NDK_FN_ACCEPT_EX retourne l’un des codes NTSTATUS suivants.
Code de retour | 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 status | Une erreur est survenue. |
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.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Pris en charge dans NDKPI 2.1 et versions ultérieures. |
Serveur minimal pris en charge | Windows Server 2022 |
Plateforme cible | Windows |
En-tête | ndkpi.h (incluez Ndkpi.h) |
IRQL | <=DISPATCH_LEVEL |
Voir aussi
NDK_FN_DISCONNECT_EVENT_CALLBACK_EX
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour