NDK_FN_ACCEPT fonction de rappel (ndkpi.h)
La fonction NdkAccept (NDK_FN_ACCEPT) accepte une demande de connexion entrante sur un objet écouteur.
Syntaxe
NDK_FN_ACCEPT NdkFnAccept;
NTSTATUS NdkFnAccept(
[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 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 à 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 au maximum du fournisseur. Si l’homologue a une valeur OutboundReadLimit inférieure, le fournisseur l’utilisera comme valeur InboundReadLimit effective. Le consommateur peut récupérer l’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 à 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 au maximum 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
Pointeur vers des 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 NdkDisconnectEventCallback (NDK_FN_DISCONNECT_EVENT_CALLBACK). 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 retourne l’un des codes NTSTATUS suivants.
| Code de retour | Description |
|---|---|
|
L’opération s’est terminée avec succès. |
|
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. |
|
L’homologue de connexion a abandonné l’établissement de connexion en attente. |
|
L’homologue n’a pas appelé la fonction CompleteConnect (NDK_FN_COMPLETE_CONNECT) pour terminer la demande de connexion en attente. |
|
Une erreur est survenue. |
Remarques
Le consommateur NDK appelle NdkAccept pour accepter une demande de connexion entrante sur un objet d’é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 | 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 |
Voir aussi
Exigences relatives à la durée de vie des objets NDKPI