NDIS_PD_CLEAR_RECEIVE_FILTER função de retorno de chamada (ndis.h)
A plataforma PacketDirect (PD) chama a função NdisPDClearReceiveFilter de um driver de miniporta compatível com PD para limpar esse filtro da plataforma PD.
Sintaxe
NDIS_PD_CLEAR_RECEIVE_FILTER NdisPdClearReceiveFilter;
VOID() NdisPdClearReceiveFilter(
[in] NDIS_PD_FILTER_HANDLE FilterHandle
)
{...}
Parâmetros
[in] FilterHandle
Um identificador para um filtro de plataforma PD.
Retornar valor
Essa função de retorno de chamada não retorna um valor.
Comentários
Depois que essa função retornar, é garantido que nenhum pacote recém-chegado corresponderá a esse filtro. No entanto, ainda pode haver pacotes em andamento que já corresponderam a esse filtro e eles estão a caminho de serem colocados na fila de recebimento de destino.
Exemplos
Para definir uma função NdisPDClearReceiveFilter , 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 escrever drivers para o sistema operacional Windows.Por exemplo, para definir uma função NdisPDClearReceiveFilter chamada "MyPDClearReceiveFilter", use o tipo NDIS_PD_CLEAR_RECEIVE_FILTER conforme mostrado neste exemplo de código:
NDIS_PD_CLEAR_RECEIVE_FILTER MyPDClearReceiveFilter;
Em seguida, implemente sua função da seguinte maneira:
_Use_decl_annotations_
VOID
MyPDClearReceiveFilter(
NDIS_PD_FILTER_HANDLE FilterHandle
)
{...}
O tipo de função NDIS_PD_CLEAR_RECEIVE_FILTER é definido no arquivo de cabeçalho Ntddndis.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 NDIS_PD_CLEAR_RECEIVE_FILTER 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 | Windows 10 |
Servidor mínimo com suporte | Windows Server 2016 |
Plataforma de Destino | Windows |
Cabeçalho | ndis.h |
IRQL | PASSIVE_LEVEL |
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de