Função NdisCoDeleteVc (ndis.h)
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.
Valor de retorno
NdisCoDeleteVc 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. |
|
Essa chamada é redundante, mas a desativação na VC fornecida ainda está pendente. |
Observações
Quando um protocolo chama NdisCoDeleteVc, não deve haver chamadas pendentes no VC especificado e essa VC já foi desativada. Atender a esses requisitos implica que as seguintes condições contêm:
- Se a quebra de chamada foi iniciada por um cliente local, esse cliente já chamou NdisClCloseCall com a NdisVcHandle fornecida e sua solicitação de chamada de fechamento foi concluída com êxito.
- Se o tear-down de chamada foi iniciado por um cliente remoto, o gerenciador de chamadas autônomo já chamou NdisCmDeactivateVc com o NdisVcHandle e sua solicitação de desativação foi concluída com êxito.
Quando NdisCoDeleteVc retorna o controle, o NdisVcHandle não é mais válido.
Os gerenciadores 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 chamada de suporte integrado ao gerenciamento de chamadas NdisMCmDeleteVc.