NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN função de retorno de chamada (netioddk.h)

A função de retorno de chamada ProviderCleanupBindingContext de um módulo de provedor executa qualquer limpeza e desalocação necessárias do contexto de associação do módulo do provedor após o módulo do provedor e um módulo de cliente terem se desanexado uns dos outros.

Sintaxe

NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN NpiProviderCleanupBindingContextFn;

void NpiProviderCleanupBindingContextFn(
  [in] PVOID ProviderBindingContext
)
{...}

Parâmetros

[in] ProviderBindingContext

Um ponteiro para o contexto do módulo do provedor para a associação entre o módulo do provedor e o módulo cliente do qual ele desanexou. A função de retorno de chamada ProviderAttachClient do módulo do provedor retorna esse ponteiro para o NMR quando ele é anexado ao módulo cliente.

Retornar valor

Nenhum

Comentários

A NMR chama a função de retorno de chamada ProviderCleanupBindingContext de um módulo de provedor depois que o provedor e um módulo cliente se desanexam um do outro.

A função de retorno de chamada ProviderCleanupBindingContext de um módulo de provedor deve executar qualquer limpeza necessária dos dados contidos na estrutura de contexto de associação do módulo do provedor. Em seguida, ele deve liberar a memória para a estrutura de contexto de associação se o módulo do provedor alocar dinamicamente a memória para a estrutura.

Se o módulo do provedor não aloca dinamicamente a memória para seu contexto de associação e nenhuma outra limpeza do contexto de associação é necessária, o módulo do provedor não precisa implementar uma função de retorno de chamada ProviderCleanupBindingContext . Se o módulo do provedor não implementar uma função de retorno de chamada ProviderCleanupBindingContext , ele deverá definir o membro ProviderCleanupBindingContext do NPI_PROVIDER_CHARACTERISTICS estrutura como NULL quando chama a função NmrRegisterProvider para se registrar no NMR.

A NMR chama a função de retorno de chamada ProviderCleanupBindingContext de um módulo de provedor em qualquer IRQL <= DISPATCH_LEVEL.

Requisitos

Confira também

ClientDetachProvider

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient

ProviderDetachClient