NDK_FN_ACCEPT função de retorno de chamada (ndkpi.h)
A função NdkAccept (NDK_FN_ACCEPT) aceita uma solicitação de conexão de entrada em um objeto de ouvinte.
Sintaxe
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
)
{...}
Parâmetros
[in] pNdkConnector
Um ponteiro para um objeto do conector NDK (NDK_CONNECTOR).
[in] pNdkQp
Um ponteiro para um objeto QP (NDK queue pair) (NDK_QP) para associar à 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 de MaxInboundReadLimit inferior 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 inboundReadLimitefetivo. 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 de 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 InboundReadLimitinferior, o provedor usará esse valor como o OutboundReadLimit efetivo. O consumidor pode recuperar o OutboundReadLimit de efetivo chamando a função NdkGetConnectionData (NDK_FN_GET_CONNECTION_DATA).
[_In_reads_bytes_opt_(PrivateDataLength)] pPrivateData
Um ponteiro para 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 NdkDisconnectEventCallback (NDK_FN_DISCONNECT_EVENT_CALLBACK). 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.
Valor de retorno
A função NDK_FN_ACCEPT retorna um dos seguintes códigos NTSTATUS.
Código de retorno | Descrição |
---|---|
|
A operação foi concluída com êxito. |
|
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. |
|
O par de conexão abandonou o estabelecimento de conexão pendente. |
|
O par não chamou a função CompleteConnect (NDK_FN_COMPLETE_CONNECT) para concluir a solicitação de conexão pendente. |
|
Ocorreu um erro. |
Observações
O consumidor do NDK chama NdkAccept 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 de 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 |
---|---|
de cliente com suporte mínimo | Nenhum com suporte, com suporte no NDIS 6.30 e posterior. |
servidor com suporte mínimo | Windows Server 2012 |
da Plataforma de Destino | Windows |
cabeçalho | ndkpi.h (inclua Ndkpi.h) |
IRQL | <=DISPATCH_LEVEL |
Consulte também
requisitos de tempo de vida do objeto NDKPI