Função NdisMCmDeleteVc (ndis.h)

Artigo
02/26/2024

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)