Macro NdisMCmOpenAddressFamilyComplete (ndis.h)
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) |