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.
Valor de retorno
NdisMCmDeleteVc pode retornar um dos seguintes:
| Código de retorno | Descrição |
|---|---|
|
O NDIS excluiu a VC. |
|
O VC ainda está ativo, portanto, não pôde ser excluído. |
Observações
Quando um driver MCM chama NdisMCmDeleteVc, não deve haver chamadas pendentes no VC especificado e essa VC deve ter sido desativada. Atender a esses requisitos implica que o driver MCM já chamou NdisMCmDeactivateVc com o NdisVcHandle 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 que ele chama NdisMCmCreateVc.
O gravador de driver determina se um driver MCM tem uma função MiniportCoDeleteVc (interna) que o driver chama no contexto de demolição de conexões para chamadas de saída e entrada.
Somente os drivers de miniporto orientados à conexão que fornecem suporte integrado ao gerenciamento de chamadas podem chamar NdisMCmDeleteVc. Os clientes e gerentes de chamadas autônomos, que se registram no NDIS como drivers de protocolo, chamam NdisCoDeleteVc.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | 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. |
| da 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_MCM_Function(ndis) |