NDK_FN_ACCEPT funzione di callback (ndkpi.h)

Articolo
08/07/2023

La funzione NdkAccept (NDK_FN_ACCEPT) accetta una richiesta di connessione in ingresso su un oggetto listener.

Sintassi

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
)
{...}

Parametri

[in] pNdkConnector

Puntatore a un oggetto connettore NDK (NDK_CONNECTOR).

[in] pNdkQp

Puntatore a un oggetto QP (NDK queue pair) (NDK_QP) da associare alla connessione.

[in] InboundReadLimit

Numero massimo fornito dal consumer delle operazioni di lettura in ingresso in corso per consentire il QP. Se il provider sottostante ha un valore MassimoInboundReadLimit inferiore nella struttura NDK_ADAPTER_INFO , il provider limiterà il valore fornito dal consumer al massimo del provider. Se il peer ha un valore outboundReadLimit inferiore, il provider userà tale valore come InboundReadLimit effettivo. Il consumer può recuperare l'effettivo InboundReadLimit chiamando la funzione NdkGetConnectionData (NDK_FN_GET_CONNECTION_DATA).

[in] OutboundReadLimit

Numero massimo di operazioni di lettura in uscita fornite dal consumer per consentire le operazioni di lettura in uscita per consentire il QP. Se il provider sottostante ha un valore MassimoOutboundReadLimit inferiore nella struttura NDK_ADAPTER_INFO , il provider limiterà il valore fornito dal consumer al massimo del provider. Se il peer ha un valore InboundReadLimit inferiore, il provider userà tale valore come outboundReadLimit effettivo. Il consumer può recuperare l'effettivo OutboundReadLimit chiamando la funzione NdkGetConnectionData (NDK_FN_GET_CONNECTION_DATA).

[_In_reads_bytes_opt_(PrivateDataLength)] pPrivateData

Puntatore ai dati privati inviati con la richiesta di accettazione.

[in] PrivateDataLength

Lunghezza, in byte, dei dati privati forniti nel parametro pPrivateData .

[in, optional] DisconnectEvent

Punto di ingresso per una funzione di callback di notifica disconnessione facoltativa NdkDisconnectEventCallback (NDK_FN_DISCONNECT_EVENT_CALLBACK). Il provider chiama questa funzione di callback quando il peer si disconnette.

[in, optional] DisconnectEventContext

Valore di contesto da passare al parametro DisconnectEventContext della funzione di callback specificata nel parametro DisconnectEvent .

[in] RequestCompletion

Puntatore a una routine di callback del completamento della richiesta NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Valore di contesto da passare al parametro Context della funzione callback specificata nel parametro RequestCompletion .

Valore restituito

La funzione NDK_FN_ACCEPT restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	Operazione riuscita.
STATUS_PENDING	L'operazione è in sospeso e verrà completata in un secondo momento. Il driver chiamerà la funzione RequestCompletion (NDK_FN_REQUEST_COMPLETION) specificata per completare l'operazione in sospeso.
STATUS_CONNECTION_ABORTED	Il peer di connessione ha abbandonato l'istituzione della connessione in sospeso.
STATUS_IO_TIMEOUT	Il peer non ha chiamato la funzione CompleteConnect (NDK_FN_COMPLETE_CONNECT) per completare la richiesta di connessione in sospeso.
Altri codici di stato	Si è verificato un errore.

Commenti

Il consumer NDK chiama NdkAccept per accettare una richiesta di connessione in ingresso su un oggetto listener.

La funzione NdkCreateListener (NDK_FN_CREATE_LISTENER) crea un oggetto listener NDK e fornisce una funzione NdkConnectEventCallback (NDK_FN_CONNECT_EVENT_CALLBACK).

La funzione NdkConnectEventCallback viene usata dal provider NDK per notificare al consumer ogni richiesta di connessione in ingresso.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuna supportata, supportata in NDIS 6.30 e versioni successive.
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Intestazione	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL