Função NdisMCoActivateVcComplete (ndis.h)

Artigo
02/26/2024

NdisMCoActivateVcComplete notifica o NDIS e o gerenciador de chamadas de que o driver de miniporto terminou de processar uma solicitação activate-VC iniciada por CM, para a qual o driver de miniporto retornou anteriormente NDIS_STATUS_PENDING.

Sintaxe

void NdisMCoActivateVcComplete(
  [in] NDIS_STATUS         Status,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parâmetros

[in] Status

Especifica o status final da operação activate-VC, que pode ser NDIS_STATUS_SUCCESS ou qualquer NDIS_STATUS_ XXX, exceto NDIS_STATUS_PENDING.

[in] NdisVcHandle

Especifica o identificador que identifica a VC. O chamador obteve esse identificador de seu estado por VC, designado pelo MiniportVcContext passado como um parâmetro de entrada para seu Função MiniportCoActivateVc .

[in] CallParameters

Ponteiro para uma estrutura do tipo CO_CALL_PARAMETERS, fornecida pelo gerenciador de chamadas, especificando os parâmetros de chamada e mídia para a ativação de VC.

Retornar valor

Nenhum

Comentários

Um driver de miniporto orientado a conexão deve chamar NdisMCoActivateVcComplete se sua função MiniportCoActivateVc retornada anteriormente NDIS_STATUS_PENDING em resposta a uma solicitação para ativar ou reativar a VC identificada pelo NdisVcHandle especificado. O gerenciador de chamadas, que iniciou a ativação de VC com uma chamada para NdisCmActivateVc, não pode notificar o NDIS ou seu cliente se as transferências na VC podem ser feitas usando os parâmetros de chamada fornecidos até que o driver de miniporto chame NdisMCoActivateVcComplete.

Se o driver de miniporto achar inaceitáveis os parâmetros de chamada fornecidos por CM, ele falhará na ativação de VC quando chamar NdisMCoActivateVcComplete. Falhar na ativação inicial de uma VC pode fazer com que o protocolo que criou a VC o derrube. Se o driver de miniporta falhar em uma solicitação para reativar uma VC estabelecida com novos parâmetros de chamada, ele deverá restaurar os parâmetros de chamada originais estabelecidos para essa VC. Dependendo da natureza da mídia de rede, um driver de miniporto poderá modificar os parâmetros de mídia se os sinalizadores de arredondamento e/ou arredondamento forem definidos antes de chamar NdisMCoActivateVcComplete.

Uma chamada para NdisMCoActivateVcComplete faz com que o NDIS chame o Função ProtocolCmActivateVcComplete do gerenciador de chamadas que solicitou originalmente a ativação de VC.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisMCoActivateVcComplete (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisMCoActivateVcComplete (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_MCO_Function(ndis)