Função NdisMCoActivateVcComplete (ndis.h)
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) |