Macro NdisMCmOpenAddressFamilyComplete (ndis.h)

Artigo
02/27/2024

NdisMCmOpenAddressFamilyComplete retorna a status final da solicitação de um cliente, para a qual a função ProtocolCmOpenAf do driver MCM retornou NDIS_STATUS_PENDING, para abrir a família de endereços do driver MCM.

Sintaxe

void NdisMCmOpenAddressFamilyComplete(
   _S_,
   _H_,
   _C_
);

Parâmetros

_S_

Especifica o status final da solicitação do cliente para abrir o AF, NDIS_STATUS_SUCCESS ou qualquer NDIS_STATUS_ XXX determinado pelo chamador, exceto NDIS_STATUS_PENDING.

_H_

Especifica o identificador fornecido pelo NDIS que foi inserido na função ProtocolCmOpenAf do driver MCM, que retornou NDIS_STATUS_PENDING.

_C_

Especifica o identificador para uma área de contexto residente alocada pelo chamador, na qual o driver MCM 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. Caso contrário, o NDIS ignorará esse parâmetro.

Retornar valor

Nenhum

Comentários

Um driver MCM deve chamar NdisMCmOpenAddressFamilyComplete 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 realizar outras operações orientadas a conexão na mesma associação até que NdisMCmOpenAddressFamilyComplete cause uma chamada para o cliente Função ProtocolClOpenAfCompleteEx .

Se o chamador de NdisMCmOpenAddressFamilyComplete 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 pelo driver MCM que dizem respeito à abertura da família de endereços do cliente até que o cliente feche o AF. O driver MCM deve liberar ou reutilizar qualquer área de contexto af alocada antes de passar uma falha status para NdisMCmOpenAddressFamilyComplete.

Para uma abertura bem-sucedida, o NdisAfHandle fornecido pelo NDIS representa uma associação entre o driver MCM e o cliente para o AF aberto. Ambos os drivers NDIS 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/Co/MCm/MCoXxx para as quais esse identificador é um parâmetro necessário. Para uma abertura com falha, o driver MCM deve considerar o NdisAfHandle inválido quando NdisMCmOpenAddressFamilyComplete retornar o controle.

Somente os drivers de miniporto orientados à conexão que fornecem suporte integrado ao gerenciamento de chamadas podem chamar NdisMCmOpenAddressFamilyComplete. Os gerentes de chamadas autônomos, que se registram no NDIS como drivers de protocolo, chamam NdisCmOpenAddressFamilyComplete .

Requisitos

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