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

  • Artigo

A função NdkCreateSharedEndpoint (NDK_FN_CREATE_SHARED_ENDPOINT) cria um ponto de extremidade compartilhado NDK.

Sintaxe

NDK_FN_CREATE_SHARED_ENDPOINT NdkFnCreateSharedEndpoint;

NTSTATUS NdkFnCreateSharedEndpoint(
  [in]           NDK_ADAPTER *pNdkAdapter,
                 const PSOCKADDR pAddress,
  [in]           ULONG AddressLength,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_SHARED_ENDPOINT **ppNdkSharedEndpoint
)
{...}

Parâmetros

[in] pNdkAdapter

Um ponteiro para um objeto de adaptador NDK (NDK_ADAPTER).

pAddress

Um endereço local a ser usado para iniciar conexões de saída. 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] CreateCompletion

Um ponteiro para uma função NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) que conclui a criação de um objeto NDK.

[in, optional] RequestContext

Um valor de contexto que o provedor NDK passa de volta para a função NdkCreateCompletion especificada no parâmetro CreateCompletion .

ppNdkSharedEndpoint

Um ponteiro para um objeto de ponto de extremidade compartilhado criado (NDK_SHARED_ENDPOINT) será retornado nesse local se a solicitação for bem-sucedida sem retornar STATUS_PENDING. Se a solicitação retornar STATUS_PENDING esse parâmetro será ignorado e o objeto criado será retornado com o retorno de chamada especificado no parâmetro CreateCompletion .

Retornar valor

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

Código de retorno Descrição
STATUS_SUCCESS
 O objeto de ponto de extremidade compartilhado foi criado com êxito e retornado com o parâmetro *ppNdkSharedEndpoint .
STATUS_PENDING
 A operação está pendente e será concluída posteriormente. O provedor chamará a função especificada no parâmetro CreateCompletion (NDK_FN_CREATE_COMPLETION) 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 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_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.)
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.
 
Outros códigos de status
 Ocorreu um erro.

Comentários

A função NdkCreateSharedEndpoint cria um ponto de extremidade compartilhado NDK a ser usado como o endereço local para várias conexões de saída destinadas a endereços remotos diferentes. Isso é análogo a ter várias conexões de entrada com o mesmo endereço local representado por um objeto ouvinte.

Se a função retornar STATUS_SUCCESS, o objeto criado será retornado no parâmetro ppNdkSharedEndpoint . Se NdkCreateSharedEndpoint retornar STATUS_PENDING, o objeto criado será retornado pela função NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) especificada no parâmetro CreateCompletion .

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_ADAPTER

NDK_ADAPTER_DISPATCH

NDK_FN_CREATE_COMPLETION

NDK_SHARED_ENDPOINT