FILTER_DEVICE_PNP_EVENT_NOTIFY função de retorno de chamada (ndis.h)
O NDIS chama a função FilterDevicePnPEventNotify de um driver de filtro para notificar o driver de eventos de PnP (Plug and Play de dispositivo) e Gerenciamento de Energia.
Sintaxe
FILTER_DEVICE_PNP_EVENT_NOTIFY FilterDevicePnpEventNotify;
void FilterDevicePnpEventNotify(
[in] NDIS_HANDLE FilterModuleContext,
[in] PNET_DEVICE_PNP_EVENT NetDevicePnPEvent
)
{...}
Parâmetros
[in] FilterModuleContext
Um identificador para a área de contexto do módulo de filtro. O driver de filtro criou e inicializou essa área de contexto na função FilterAttach .
[in] NetDevicePnPEvent
Um ponteiro para uma estrutura de NET_DEVICE_PNP_EVENT que descreve um evento de Plug and Play do dispositivo.
Retornar valor
Nenhum
Comentários
FilterDevicePnPEventNotify é uma função opcional. Se um driver de filtro não usar solicitações PnP do dispositivo, ele poderá definir o ponto de entrada dessa função como NULL quando chamar o Função NdisFRegisterFilterDriver .
FilterDevicePnPEventNotify é semelhante ao de um driver de miniport Função MiniportDevicePnPEventNotify . Os drivers de filtro podem encaminhar essas notificações para drivers subjacentes. Para encaminhar uma solicitação, chame o Função NdisFDevicePnPEventNotify .
O NDIS chama FilterDevicePnPEventNotify em IRQL = PASSIVE_LEVEL.
Exemplos
Para definir uma função FilterDevicePnPEventNotify , 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 FilterDevicePnPEventNotify chamada "MyDevicePnPEventNotify", use o tipo FILTER_DEVICE_PNP_EVENT_NOTIFY conforme mostrado neste exemplo de código:
FILTER_DEVICE_PNP_EVENT_NOTIFY MyDevicePnPEventNotify;
Em seguida, implemente sua função da seguinte maneira:
_Use_decl_annotations_
VOID
MyDevicePnPEventNotify(
NDIS_HANDLE FilterModuleContext,
PNET_DEVICE_PNP_EVENT NetDevicePnPEvent
)
{...}
O tipo de função FILTER_DEVICE_PNP_EVENT_NOTIFY é 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 FILTER_DEVICE_PNP_EVENT_NOTIFY 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 no NDIS 6.0 e posterior. |
Plataforma de Destino | Windows |
Cabeçalho | ndis.h (inclua Ndis.h) |
IRQL | PASSIVE_LEVEL |
Confira também
MiniportDevicePnPEventNotifyComentá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