Função NdisCmOpenAddressFamilyComplete (ndis.h)

NdisCmOpenAddressFamilyComplete retorna a status final da abertura de um determinado AF de um gerenciador de chamadas autônomo para 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 o aberto tiver sido bem-sucedido. Se Status não for NDIS_STATUS_SUCCESS, o NDIS ignorará esse parâmetro.

Retornar valor

Nenhum

Comentários

Um gerenciador de chamadas autônomo deve chamar NdisCmOpenAddressFamilyComplete se sua função ProtocolCmOpenAf retornada anteriormente NDIS_STATUS_PENDING para o NdisAfHandle especificado. O cliente, que iniciou a operação open-AF pendente com uma chamada para NdisClOpenAddressFamilyEx, não pode executar outras operações orientadas a conexão na mesma associação até que NdisCmOpenAddressFamilyComplete cause uma chamada para o cliente Função ProtocolClOpenAfCompleteEx .

Se o chamador de NdisCmOpenAddressFamilyComplete definir Status como NDIS_STATUS_SUCCESS, o NDIS passará posteriormente o identificador CallMgrAfContext fornecido como um parâmetro de entrada para todas as funções ProtocolCmXxx e ProtocolCoXxx fornecidas por CM que dizem respeito à abertura da família de endereços pelo cliente até que o cliente feche o AF. O gerenciador de chamadas deve liberar ou reutilizar qualquer área de contexto af alocada antes de passar uma falha status 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 retornar 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 .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisCmOpenAddressFamilyComplete (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisCmOpenAddressFamilyComplete (NDIS 5.1)) no Windows XP.
Plataforma de Destino	Área de Trabalho
Cabeçalho	ndis.h (inclua Ndis.h)
Biblioteca	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regras de conformidade da DDI	Irql_CallManager_Function(ndis)

Confira também

NdisAllocateFromNPagedLookasideList

NdisClOpenAddressFamilyEx

NdisMCmOpenAddressFamilyComplete

ProtocolClOpenAfCompleteEx

ProtocolCmOpenAf