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

Artigo
08/07/2023

A função NdkCloseObject (NDK_FN_CLOSE_OBJECT) inicia uma solicitação de fechamento para um objeto NDK.

Sintaxe

NDK_FN_CLOSE_OBJECT NdkFnCloseObject;

NTSTATUS NdkFnCloseObject(
  [in]           NDK_OBJECT_HEADER *pNdkObject,
  [in]           NDK_FN_CLOSE_COMPLETION CloseCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parâmetros

[in] pNdkObject

Um ponteiro para o cabeçalho do objeto (NDK_OBJECT_HEADER) para o objeto fechar.

[in] CloseCompletion

Um ponteiro para uma função de retorno de chamada de conclusão de conclusão NdkCloseCompletion (NDK_FN_CLOSE_COMPLETION).

[in, optional] RequestContext

Um valor de contexto para o provedor NDK passar de volta para a função NdkCloseCompletion especificada no parâmetro CloseCompletion .

Retornar valor

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

Código de retorno	Descrição
STATUS_SUCCESS	O objeto NDK é fechado. O provedor não chamará a função NdkCloseCompletion .
STATUS_PENDING	A solicitação está pendente, o provedor chamará a função NdkCloseCompletion para concluir a operação de forma assíncrona. A solicitação de fechamento foi iniciada com êxito, mas pode não ser concluída.
Outros códigos status	Ocorreu um erro.

Comentários

A tabela de expedição de função para cada tipo de objeto NDK inclui um ponteiro de função NDK_FN_CLOSE_OBJECT . As solicitações de fechamento são assíncronas. Um consumidor do NDK não deve acessar o objeto depois que uma solicitação de fechamento é iniciada.

O provedor NDK deve garantir que a função NdkCloseCompletion (NDK_FN_CLOSE_COMPLETION) seja o último retorno de chamada chamado para o objeto que está fechando. O provedor deve garantir que todas as solicitações assíncronas pendentes sejam concluídas e que todos os retornos de chamada em andamento tenham retornado e que outros retornos de chamada sejam evitados antes que o provedor chame a função NdkCloseCompletion . Depois que o provedor chamar a função NdkCloseCompletion , o provedor não chamará nenhuma função de conclusão ou funções de retorno de chamada de notificação para o objeto.

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