NDK_FN_ACCEPT_EX função de retorno de chamada (ndkpi.h)

Artigo
08/07/2023

A função NdkAcceptEx (NDK_FN_ACCEPT_EX) aceita uma solicitação de conexão de entrada em um objeto ouvinte.

Sintaxe

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

Parâmetros

[in] pNdkConnector

Um ponteiro para um objeto de conector NDK (NDK_CONNECTOR).

[in] pNdkQp

Um ponteiro para um objeto de QP (par de filas) NDK (NDK_QP) a ser associado à conexão.

[in] InboundReadLimit

O número máximo de operações de leitura em andamento fornecidas pelo consumidor para permitir no QP. Se o provedor subjacente tiver um valor MaxInboundReadLimit menor na estrutura NDK_ADAPTER_INFO , o provedor limitará o valor fornecido pelo consumidor ao máximo do provedor. Se o par tiver um valor OutboundReadLimit menor, o provedor usará esse valor como o InboundReadLimit efetivo. O consumidor pode recuperar o InboundReadLimit efetivo chamando a função NdkGetConnectionData (NDK_FN_GET_CONNECTION_DATA).

[in] OutboundReadLimit

O número máximo fornecido pelo consumidor de operações de leitura em andamento de saída para permitir no QP. Se o provedor subjacente tiver um valor MaxOutboundReadLimit menor na estrutura NDK_ADAPTER_INFO , o provedor limitará o valor fornecido pelo consumidor ao máximo do provedor. Se o par tiver um InboundReadLimit menor, o provedor usará esse valor como o OutboundReadLimit efetivo. O consumidor pode recuperar o OutboundReadLimit efetivo chamando a função NdkGetConnectionData (NDK_FN_GET_CONNECTION_DATA).

[_In_reads_bytes_opt_(PrivateDataLength)] pPrivateData

Dados privados que são enviados de volta com a solicitação de aceitação.

[in] PrivateDataLength

O comprimento, em bytes, dos dados privados fornecidos no parâmetro pPrivateData .

[in, optional] DisconnectEvent

Um ponto de entrada para uma função de retorno de chamada de notificação de desconexão opcional NdkDisconnectEventCallbackEx NDK_FN_DISCONNECT_EVENT_CALLBACK_EX. O provedor chama essa função de retorno de chamada quando o par se desconecta.

[in, optional] DisconnectEventContext

Um valor de contexto a ser passado para o parâmetro DisconnectEventContext da função de retorno de chamada especificada no parâmetro DisconnectEvent .

[in] RequestCompletion

Um ponteiro para uma rotina de retorno de chamada de conclusão de solicitação NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Um valor de contexto a ser passado para o parâmetro Context da função de retorno de chamada especificada no parâmetro RequestCompletion .

Retornar valor

A função NDK_FN_ACCEPT_EX retorna um dos seguintes códigos NTSTATUS.

Código de retorno	Descrição
STATUS_SUCCESS	A operação foi concluída com sucesso.
STATUS_PENDING	A operação está pendente e será concluída posteriormente. O driver chamará a função RequestCompletion (NDK_FN_REQUEST_COMPLETION) especificada para concluir a operação pendente.
STATUS_CONNECTION_ABORTED	O par de conexão abandonou o estabelecimento de conexão pendente.
STATUS_IO_TIMEOUT	O par não chamou a função CompleteConnect (NDK_FN_COMPLETE_CONNECT_EX) para concluir a solicitação de conexão pendente.
Outros códigos de status	Ocorreu um erro.

Comentários

O consumidor do NDK chama NdkAcceptEx para aceitar uma solicitação de conexão de entrada em um objeto de ouvinte.

A função NdkCreateListener (NDK_FN_CREATE_LISTENER) cria um objeto ouvinte NDK e fornece uma função NdkConnectEventCallback (NDK_FN_CONNECT_EVENT_CALLBACK).

A função NdkConnectEventCallback é usada pelo provedor NDK para notificar o consumidor sobre cada solicitação de conexão de entrada.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte no NDKPI 2.1 e posterior.
Servidor mínimo com suporte	Windows Server 2022
Plataforma de Destino	Windows
Cabeçalho	ndkpi.h (inclua Ndkpi.h)
IRQL	<=DISPATCH_LEVEL