Função NdisCmOpenAddressFamilyComplete (ndis.h)
NdisCmOpenAddressFamilyComplete retorna o status final da abertura de um determinado AF de um determinado cliente por um determinado cliente depois que o gerenciador de chamadas retornou NDIS_STATUS_PENDING em resposta à solicitação original open-AF desse cliente.
Sintaxe
void NdisCmOpenAddressFamilyComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisAfHandle,
[in] NDIS_HANDLE CallMgrAfContext
);
Parâmetros
[in] Status
Especifica o status final da operação open-AF, NDIS_STATUS_SUCCESS ou qualquer erro determinado por CM NDIS_STATUS_ XXX, exceto NDIS_STATUS_PENDING.
[in] NdisAfHandle
Especifica o identificador fornecido pelo NDIS que foi inserido na função ProtocolCmOpenAf do gerenciador de chamadas, que retornou NDIS_STATUS_PENDING.
[in] CallMgrAfContext
Especifica o identificador para uma área de contexto residente alocada pelo chamador na qual o gerenciador de chamadas mantém o estado sobre a abertura desse cliente da família de endereços, incluindo o NdisAfHandle, se a abertura tiver sido bem-sucedida. Se status não for NDIS_STATUS_SUCCESS, o NDIS ignorará esse parâmetro.
Valor de retorno
Nenhum
Observações
Um gerenciador de chamadas autônomo deve chamar NdisCmOpenAddressFamilyComplete se sua função ProtocolCmOpenAf retornada anteriormente NDIS_STATUS_PENDING para o NdisAfHandle fornecido. O cliente, que iniciou a operação open-AF pendente com uma chamada para NdisClOpenAddressFamilyEx, não pode realizar outras operações orientadas à conexão na mesma associação até NdisCmOpenAddressFamilyComplete causar uma chamada para o cliente função ProtocolClOpenAfCompleteEx.
Se o chamador de NdisCmOpenAddressFamilyComplete definir Status como NDIS_STATUS_SUCCESS, Posteriormente, o NDIS passa o identificador CallMgrAfContext fornecido como um parâmetro de entrada para todas as funçõesXxx e ProtocolCoXxx que dizem respeito à abertura da família de endereços pelo cliente até que o cliente feche a AF. O gerenciador de chamadas deve liberar ou reutilizar qualquer área de contexto af alocada antes de passar um status de falha para NdisCmOpenAddressFamilyComplete.
Para uma abertura bem-sucedida, o NdisAfHandle fornecido pelo NDIS representa uma associação entre o gerenciador de chamadas e o cliente para o AF aberto em um driver de miniporto específico ao qual o gerenciador de chamadas e o cliente estão associados. Ambos os drivers de protocolo devem tratar NdisAfHandle como uma variável opaca a ser passada, não modificada e não interpretada, em chamadas subsequentes para funções NdisCl/Cm/CoXxx para as quais esse identificador é um parâmetro necessário. Para uma abertura com falha, o gerenciador de chamadas deve considerar o NdisAfHandle inválido quando NdisMCmOpenAddressFamilyComplete retorna o controle.
Somente os gerenciadores de chamadas autônomos, que se registram no NDIS como drivers de protocolo, podem chamar NdisCmOpenAddressFamilyComplete. Os drivers de miniporto orientados para conexão que fornecem suporte integrado ao gerenciamento de chamadas devem chamar NdisMCmOpenAddressFamilyComplete.