Macro NdisMCmOpenAddressFamilyComplete (ndis.h)
NdisMCmOpenAddressFamilyComplete retorna o status final da solicitação de um cliente, para a qual a função ProtocolCmOpenAf do driver MCM retornada 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 XXX NDIS_STATUS_ 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 de 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 a NdisAfHandle, se a abertura tiver sido bem-sucedida. Caso contrário, o NDIS ignorará esse parâmetro.
Valor de retorno
Nenhum
Observações
Um driver MCM deve chamar NdisMCmOpenAddressFamilyComplete 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é NdisMCmOpenAddressFamilyComplete causa uma chamada para o cliente função ProtocolClOpenAfCompleteEx.
Se o chamador de NdisMCmOpenAddressFamilyComplete definir Status como NDIS_STATUS_SUCCESS, Posteriormente, o NDIS passa o identificador CallMgrAfContext fornecido como um parâmetro de entrada para todas as funções ProtocolCm fornecidas pelo driver MCMXxx e ProtocolCoXxx que dizem respeito à abertura da família de endereços do cliente até que o cliente feche a AF. O driver MCM deve liberar ou reutilizar qualquer área de contexto af alocada antes de passar um status de falha 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 retorna o controle.
Somente drivers de miniporto orientados à conexão que fornecem suporte integrado ao gerenciamento de chamadas podem chamar NdisMCmOpenAddressFamilyComplete. Os gerenciadores de chamadas autônomos, que se registram no NDIS como drivers de protocolo, chamam NdisCmOpenAddressFamilyComplete em vez disso.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | 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. |
| da 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) |