Função NdisCoDeleteVc (ndis.h)

Artigo
08/07/2023

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)