NDK_FN_CREATE_SHARED_ENDPOINT função de retorno de chamada (ndkpi.h)
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 |
---|---|
|
O objeto de ponto de extremidade compartilhado foi criado com êxito e retornado com o parâmetro *ppNdkSharedEndpoint . |
|
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. |
|
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.
|
|
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.
|
|
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.) |
|
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.
|
|
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 |