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 |
|---|---|
|
O NDIS excluiu a VC. |
|
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) |