PROTOCOL_CLOSE_ADAPTER_COMPLETE_EX função de retorno de chamada (ndis.h)

O NDIS chama a função ProtocolCloseAdapterCompleteEx de um driver de protocolo para concluir uma operação de adaptador próxima para a qual a função NdisCloseAdapterEx retornou NDIS_STATUS_PENDING.

Nota Você deve declarar a função usando o tipo PROTOCOL_CLOSE_ADAPTER_COMPLETE_EX . Para obter mais informações, consulte a seção Exemplos a seguir.

Sintaxe

PROTOCOL_CLOSE_ADAPTER_COMPLETE_EX ProtocolCloseAdapterCompleteEx;

void ProtocolCloseAdapterCompleteEx(
  [in] NDIS_HANDLE ProtocolBindingContext
)
{...}

Parâmetros

[in] ProtocolBindingContext

Um handle para uma área de contexto alocada pelo driver de protocolo. O driver de protocolo mantém as informações de contexto por associação nessa área de contexto. O driver forneceu esse handle para NDIS quando o driver chamou a função NdisOpenAdapterEx .

Valor retornado

Nenhum

Comentários

ProtocolCloseAdapterCompleteEx é uma função necessária.

Se ProtocolUnbindAdapterEx estiver aguardando que o NDIS chame ProtocolCloseAdapterCompleteEx, essa função poderá simplesmente indicar que ele foi chamado e retornar (por exemplo, ele atualiza a área de contexto ProtocolBindingContext ). Isso permite que a função ProtocolCloseAdapterCompleteEx conclua a operação de desavinculação.

Depois que o driver de protocolo chama a função NdisCloseAdapterEx , o NdisBindingHandle trata que a função NdisOpenAdapterEx retornada não é mais válida. Portanto, ProtocolCloseAdapterCompleteEx não pode chamar nenhuma função NdisXxx que exige esse handle como um parâmetro.

Se a função ProtocolUnbindAdapterEx ainda não tiver feito isso, ProtocolCloseAdapterCompleteEx poderá liberar os recursos alocados pelo driver de protocolo para operações de E/S de rede por associação.

Se ProtocolUnbindAdapterEx retornou NDIS_STATUS_PENDING e salvou o alçamento UnbindContext na área de contexto em ProtocolBindingContext, ProtocolCloseAdapterCompleteEx poderá chamar a função NdisCompleteUnbindAdapterEx para concluir a operação de desavinculação. Consequentemente, ProtocolCloseAdapterCompleteEx não deve liberar a área de contexto até depois de chamar NdisCompleteUnbindAdapterEx.

O NDIS chama ProtocolCloseAdapterCompleteEx no IRQL = PASSIVE_LEVEL.

Exemplos

Para definir uma função ProtocolCloseAdapterCompleteEx , primeiro você deve fornecer uma declaração de função que identifique o tipo de função que está definindo. Windows fornece um conjunto de tipos de função para drivers. Declarar uma função usando os tipos de função ajuda Code Analysis drivers, SDV (Verificador de Driver Estático) e outras ferramentas de verificação a encontrar erros e é um requisito para escrever drivers para o sistema operacional Windows.

Por exemplo, para definir uma função ProtocolCloseAdapterCompleteEx chamada "MyCloseAdapterCompleteEx", use o tipo PROTOCOL_CLOSE_ADAPTER_COMPLETE_EX , conforme mostrado neste exemplo de código:

PROTOCOL_CLOSE_ADAPTER_COMPLETE_EX MyCloseAdapterCompleteEx;

Em seguida, implemente sua função da seguinte forma:

_Use_decl_annotations_
VOID
 MyCloseAdapterCompleteEx(
    NDIS_HANDLE  ProtocolBindingContext
    )
  {...}

O PROTOCOL_CLOSE_ADAPTER_COMPLETE_EX de função é definido no arquivo de header Ndis.h. Para identificar erros com mais precisão ao executar as ferramentas de análise de código, adicione a anotação Use_decl_annotations à sua definição de função. A Use_decl_annotations anotação garante que as anotações aplicadas ao tipo PROTOCOL_CLOSE_ADAPTER_COMPLETE_EX função no arquivo de header sejam usadas. Para obter mais informações sobre os requisitos para declarações de função, consulte Declarando funções usando tipos de função de função para drivers NDIS.

Para obter informações sobre Use_decl_annotations, consulte Anotando o comportamento da função.

Requisitos

   
Cliente mínimo com suporte Com suporte no NDIS 6.0 e posterior.
Plataforma de Destino Windows
Cabeçalho ndis.h (inclua Ndis.h)
IRQL PASSIVE_LEVEL

Confira também

NdisCloseAdapterEx

NdisCompleteUnbindAdapterEx

NdisOpenAdapterEx

ProtocolUnbindAdapterEx