Compartilhar via


Função NdisMCmDeleteVc (ndis.h)

NdisMCmDeleteVc destrói uma VC criada pelo chamador.

Sintaxe

NDIS_STATUS NdisMCmDeleteVc(
  [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 NdisMCmCreateVc.

Retornar valor

NdisMCmDeleteVc 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.

Comentários

Quando um driver MCM chama NdisMCmDeleteVc, não deve haver chamadas pendentes na VC fornecida e essa VC deve ter sido desativada. Atender a esses requisitos implica que o driver MCM já chamou NdisMCmDeactivateVc com o NdisVcHandle fornecido com êxito.

Somente o driver que criou uma VC específica pode excluir essa VC. Uma chamada para NdisMCmDeleteVc faz com que o NDIS chame a função ProtocolCoDeleteVc do cliente com a qual o chamador compartilha o NdisVcHandle .

Quando NdisMCmDeleteVc retorna o controle, o NdisVcHandle não é mais válido. O driver MCM pode liberar os recursos alocados para manter o estado sobre a VC excluída ou prepará-los para reutilização em uma notificação de chamada de entrada subsequente depois de chamar NdisMCmCreateVc.

O gravador de driver determina se um driver MCM tem uma função MiniportCoDeleteVc (interna) que o driver chama no contexto de desativação de conexões para chamadas de saída e de entrada.

Somente os drivers de miniporto orientados a conexão que fornecem suporte integrado ao gerenciamento de chamadas podem chamar NdisMCmDeleteVc. Clientes e gerenciadores de chamadas autônomos, que se registram no NDIS como drivers de protocolo, chamam NdisCoDeleteVc .

Requisitos

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

Confira também

MiniportCoDeleteVc

NdisClCloseCall

NdisCoDeleteVc

NdisMCmCreateVc

NdisMCmDeactivateVc

ProtocolCoDeleteVc