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

Artigo
02/07/2025

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 um NdkCloseCompletion função de retorno de chamada de conclusão de fechamento (NDK_FN_CLOSE_COMPLETION).

[in, optional] RequestContext

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

Valor de retorno

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

Código de retorno	Descrição
STATUS_SUCCESS	O objeto NDK está 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 de status	Ocorreu um erro.

Observações

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
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

Consulte também

requisitos de tempo de vida do objeto NDKPI

NDK_CONNECTOR_DISPATCH

NDK_CQ_DISPATCH

NDK_FN_CLOSE_COMPLETION

NDK_OBJECT_HEADER

Partilhar via