Função NdisFNetPnPEvent (ndis.h)

Artigo
02/07/2025

Um driver de filtro pode chamar a função NdisFNetPnPEvent para encaminhar um evento PnP (Plug and Play) de rede ou de Gerenciamento de Energia para drivers sobrepostos.

Sintaxe

NDIS_STATUS NdisFNetPnPEvent(
  NDIS_HANDLE                 NdisFilterHandle,
  PNET_PNP_EVENT_NOTIFICATION NetPnPEventNotification
);

Parâmetros

NdisFilterHandle

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.

NetPnPEventNotification

Um ponteiro para um NET_PNP_EVENT_NOTIFICATION estrutura, que descreve o evento PnP de rede ou o evento de Gerenciamento de Energia sendo encaminhado pelo driver de filtro.

Valor de retorno

NdisFNetPnPEvent pode retornar um dos seguintes:

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	O driver sobreposto conseguiu processar o evento PnP.
NDIS_STATUS_FAILURE	O driver sobreposto falhou no evento PnP.

Observações

O NDIS chama a função FilterNetPnPEvent de um driver de filtro para notificar o driver de filtro de eventos de rede PnP e Gerenciamento de Energia.

Os drivers de filtro podem encaminhar essas notificações para drivers em excesso. Para encaminhar uma solicitação, chame a função NdisFNetPnPEvent de FilterNetPnPEvent.

Observação drivers NDIS não devem chamar NdisFNetPnPEvent de dentro do contexto da função FilterOidRequest.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte no NDIS 6.0 e posterior.
da Plataforma de Destino	Área de trabalho
cabeçalho	ndis.h (inclua Ndis.h)
biblioteca	Ndis.lib
IRQL	PASSIVE_LEVEL
regras de conformidade de DDI	Irql_Filter_Driver_Function(ndis)

Consulte também

FilterAttach

FilterNetPnPEvent

FilterOidRequest

NET_PNP_EVENT_NOTIFICATION

Partilhar via