NDK_FN_ACCEPT funzione di callback (ndkpi.h)
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 |
---|---|
|
Operazione riuscita. |
|
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. |
|
Il peer di connessione ha abbandonato l'istituzione della connessione in sospeso. |
|
Il peer non ha chiamato la funzione CompleteConnect (NDK_FN_COMPLETE_CONNECT) per completare la richiesta di connessione in sospeso. |
|
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 |
Vedi anche
Requisiti di durata dell'oggetto ND KPI