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

Artigo
02/07/2025

A função NdkListen (NDK_FN_LISTEN) coloca um objeto ouvinte NDK no modo de escuta.

Sintaxe

NDK_FN_LISTEN NdkFnListen;

NTSTATUS NdkFnListen(
  [in]           NDK_LISTENER *pNdkListener,
                 const PSOCKADDR pAddress,
  [in]           ULONG AddressLength,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parâmetros

[in] pNdkListener

Um ponteiro para um objeto de ouvinte do NDK (NDK_LISTENER).

pAddress

Um endereço local para escutar. Para AF_INET ou AF_INET6 pAddress contém o endereço IP local e a porta ND local.

[in] AddressLength

O tamanho, em bytes, dos dados de endereço local no parâmetro pAddress.

[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 NdkListen retorna um dos seguintes códigos NTSTATUS.

Código de retorno	Descrição
STATUS_SUCCESS	A solicitação de escuta foi bem-sucedida.
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_INSUFFICIENT_RESOURCES	A solicitação falhou devido a recursos insuficientes. Importante A solicitação pode falhar embutida, bem como de forma assíncrona com esse código de status.
STATUS_SHARING_VIOLATION	A solicitação falhou porque o endereço local especificado já está em uso. Importante A solicitação pode falhar embutida, bem como de forma assíncrona com esse código de status.
STATUS_INVALID_ADDRESS	A solicitação falhou porque o endereço local especificado não é um endereço válido para o adaptador. Importante A solicitação pode falhar embutida, bem como de forma assíncrona com esse código de status.
STATUS_TOO_MANY_ADDRESSES	A solicitação falhou porque o consumidor especificou um número de porta local de zero e o provedor do Network Direct não pôde alocar uma porta do espaço de porta efêmero (portas 49152-65535).)
Outros códigos de status	Ocorreu um erro.

Observações

NdkListen coloca um objeto ouvinte no modo de escuta no endereço local especificado.

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

NDK_FN_REQUEST_COMPLETION

NDK_LISTENER

Compartilhar via