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

  • Artigo

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 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 .

Retornar valor

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
 Falha na solicitação devido a recursos insuficientes.
Importante A solicitação pode falhar embutida, bem como de forma assíncrona com esse código 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 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 status.
 
STATUS_TOO_MANY_ADDRESSES
 A solicitação falhou porque o consumidor especificou um número de porta local de zero, e o provedor De Rede Direta não pôde alocar uma porta do espaço de porta efêmero (portas 49152-65535).)
Outros códigos status
 Ocorreu um erro.

Comentários

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum com suporte, com suporte no NDIS 6.30 e posterior.
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Windows
Cabeçalho ndkpi.h (inclua Ndkpi.h)
IRQL <=DISPATCH_LEVEL

Confira também

Requisitos de tempo de vida do objeto NDKPI

NDK_FN_REQUEST_COMPLETION

NDK_LISTENER