Partager via


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
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) pour terminer la demande de connexion en attente.
Autres codes status
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

NDK_ADAPTER_INFO

NDK_CONNECTOR

NDK_CONNECTOR_DISPATCH

NDK_FN_COMPLETE_CONNECT

NDK_FN_CONNECT_EVENT_CALLBACK

NDK_FN_CREATE_LISTENER

NDK_FN_DISCONNECT_EVENT_CALLBACK

NDK_FN_GET_CONNECTION_DATA

NDK_FN_REJECT

NDK_FN_REQUEST_COMPLETION

NDK_QP