MINIPORT_CO_DELETE_VC função de retorno de chamada (ndis.h)

  • Artigo

A função MiniportCoDeleteVc é necessária para miniportos orientados à conexão. MiniportCoDeleteVc indica que uma VC está sendo demolida e excluída pelo NDIS.

Nota Você deve declarar a função usando o tipo MINIPORT_CO_DELETE_VC . Para obter mais informações, consulte a seção Exemplos a seguir.
 

Sintaxe

MINIPORT_CO_DELETE_VC MiniportCoDeleteVc;

NDIS_STATUS MiniportCoDeleteVc(
  [in] NDIS_HANDLE MiniportVcContext
)
{...}

Parâmetros

[in] MiniportVcContext

Especifica o identificador para uma área de contexto alocada pelo driver de miniporto na qual o driver de miniporto mantém seu estado por VC. O driver de miniporto forneceu esse identificador para o NDIS de sua função MiniportCoCreateVc .

Retornar valor

Código de retorno Descrição
NDIS_STATUS_SUCCESS
 Indica que o driver de miniporte liberou com êxito todos os recursos alocados para essa VC.

Comentários

MiniportCoDeleteVc deve ser gravado como uma função síncrona e não pode, em nenhuma circunstância, retornar NDIS_STATUS_PENDING sem causar uma falha em todo o sistema.

MiniportCoDeleteVc libera todos os recursos alocados por VC e armazenados na área de contexto MiniportVcContext . O driver de miniporte também deve liberar o MiniportVcContext alocado em sua função MiniportCoCreateVc .

Exemplos

Para definir uma função MiniportCoDeleteVc , primeiro você deve fornecer uma declaração de função que identifique o tipo de função que você está definindo. O Windows fornece um conjunto de tipos de função para drivers. Declarar uma função usando os tipos de função ajuda a Análise de Código para Drivers, SDV ( Verificador de Driver Estático ) e outras ferramentas de verificação a encontrar erros e é um requisito para gravar drivers para o sistema operacional Windows.

Por exemplo, para definir uma função MiniportCoDeleteVc chamada "MyCoDeleteVc", use o tipo MINIPORT_CO_DELETE_VC conforme mostrado neste exemplo de código:

MINIPORT_CO_DELETE_VC MyCoDeleteVc;

Em seguida, implemente sua função da seguinte maneira:

_Use_decl_annotations_
NDIS_STATUS
 MyCoDeleteVc(
    NDIS_HANDLE  MiniportVcContext
    )
  {...}

O tipo de função MINIPORT_CO_DELETE_VC é definido no arquivo de cabeçalho Ndis.h. Para identificar erros com mais precisão ao executar as ferramentas de análise de código, adicione a anotação Use_decl_annotations à sua definição de função. A anotação Use_decl_annotations garante que as anotações aplicadas ao tipo de função MINIPORT_CO_DELETE_VC no arquivo de cabeçalho sejam usadas. Para obter mais informações sobre os requisitos para declarações de função, consulte Declarando funções usando tipos de função de função para drivers NDIS.

Para obter informações sobre Use_decl_annotations, consulte Anotando o comportamento da função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte para drivers NDIS 6.0 e NDIS 5.1 (confira MiniportCoDeleteVc (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte MiniportCoDeleteVc (NDIS 5.1)) no Windows XP.
Plataforma de Destino Windows
Cabeçalho ndis.h (inclua Ndis.h)
IRQL <= DISPATCH_LEVEL

Confira também

MiniportCoCreateVc