Compartilhar via


Função NdisCoDeleteVc (ndis.h)

NdisCoDeleteVc destrói uma VC criada pelo chamador.

Sintaxe

NDIS_STATUS NdisCoDeleteVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parâmetros

[in] NdisVcHandle

Especifica o identificador que identifica a VC a ser excluída. O chamador obteve originalmente esse identificador de NdisCoCreateVc.

Retornar valor

NdisCoDeleteVc pode retornar um dos seguintes:

Código de retorno Descrição
NDIS_STATUS_SUCCESS
O NDIS excluiu a VC.
NDIS_STATUS_NOT_ACCEPTED
A VC ainda está ativa, portanto, não pôde ser excluída.
NDIS_STATUS_CLOSING
Essa chamada é redundante, mas a desativação na VC fornecida ainda está pendente.

Comentários

Quando um protocolo chama NdisCoDeleteVc, não deve haver chamadas pendentes na VC fornecida e essa VC já foi desativada. Atender a esses requisitos implica que as seguintes condições são:

  • Se a desativação da chamada foi iniciada por um cliente local, esse cliente já chamou NdisClCloseCall com o NdisVcHandle fornecido e sua solicitação de chamada próxima foi concluída com êxito.
  • Se a desativação da chamada foi iniciada por um cliente remoto, o gerenciador de chamadas autônomo já chamou NdisCmDeactivateVc com o NdisVcHandle fornecido e sua solicitação de desativação foi concluída com êxito.
Somente o protocolo que criou uma VC específica pode excluir essa VC. Uma chamada para NdisCoDeleteVc faz com que o NDIS chame a função MiniportCoDeleteVc do driver de miniporte subjacente e a função ProtocolCoDeleteVc do cliente ou do gerenciador de chamadas com a qual o chamador compartilha o NdisVcHandle .

Quando NdisCoDeleteVc retorna o controle, o NdisVcHandle não é mais válido.

Os gerentes de chamadas autônomos, que se registram no NDIS como drivers de protocolo, podem chamar NdisCoDeleteVc. Drivers de miniporto orientados para conexão que fornecem suporte integrado ao gerenciamento de chamadas chamam NdisMCmDeleteVc .

Requisitos

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

Confira também

MiniportCoDeleteVc

NdisClCloseCall

NdisCmDeactivateVc

NdisCoCreateVc

NdisMCmDeleteVc

ProtocolClCloseCallComplete

ProtocolClIncomingCloseCall

ProtocolCmCloseCall

ProtocolCoDeleteVc