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

Artigo
02/07/2025

A função NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) conclui a criação de um objeto NDK.

Sintaxe

NDK_FN_CREATE_COMPLETION NdkFnCreateCompletion;

void NdkFnCreateCompletion(
  [in, optional] PVOID Context,
  [in]           NTSTATUS Status,
  [in]           NDK_OBJECT_HEADER *pNdkObject
)
{...}

Parâmetros

[in, optional] Context

O valor de contexto passado para o provedor NDK quando um consumidor chama uma função de criação de objeto. A função de criação fornece o contexto com a solicitação de conclusão de criação assíncrona ponteiro de função NdkCreateCompletion (NDK_FN_CREATE_COMPLETION).

[in] Status

O status de conclusão assíncrono para a solicitação de criação. Consulte as funções de criação de objeto (por exemplo, NDK_FN_CREATE_CQ) para obter códigos de status de conclusão que podem ser retornados para cada tipo de objeto.

[in] pNdkObject

Um ponteiro para um cabeçalho de objeto NDK (NDK_OBJECT_HEADER).

Valor de retorno

Nenhum

Observações

Observação Essa função é implementada pelo consumidor do NDK e passada para o provedor NDK.

Objetos NDK são criados com funções assíncronas. Essas funções de criação de objeto assíncrona assumem um ponteiro de função NDK_FN_CREATE_COMPLETION como um parâmetro de entrada.

Um provedor NDK pode retornar STATUS_PENDING de uma função de criação de objeto assíncrona. Nesse caso, o provedor NDK deve chamar a função de criação de conclusão para indicar que a criação do objeto está concluída.

Qualquer status outro código de status indica a conclusão embutida. Nesse caso, o provedor não deve chamar a função de conclusão da solicitação de criação. Se a função criar solicitação retornar um código de status NT_STATUS diferente de STATUS_PENDING, o objeto criado deverá ser retornado em um parâmetro de saída com a função create request.

Para criar solicitações que retornam STATUS_PENDING e posteriores concluídas com STATUS_SUCCESS de forma assíncrona, o objeto criado deve ser retornado pela função create completion com o parâmetro pNdkObject e o provedor não deve acessar o parâmetro de saída do objeto da função create request.

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