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

Artigo
08/07/2023

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 o ponteiro da função de solicitação de conclusão de criação assíncrona NdkCreateCompletion (NDK_FN_CREATE_COMPLETION).

[in] Status

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

[in] pNdkObject

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

Retornar valor

Nenhum

Comentários

Nota 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íncronas 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 conclusão create para indicar que a criação do objeto está concluída.

Qualquer status outro código status indica a conclusão embutida. Nesse caso, o provedor não deve chamar a função de conclusão de solicitação de criação. Se a função create request retornar um código NT_STATUS 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 solicitações de criação 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
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