estrutura NET_PNP_EVENT_NOTIFICATION (ndis.h)

Artigo
02/26/2024

A estrutura NET_PNP_EVENT_NOTIFICATION descreve um evento de PnP (Plug and Play de rede), um evento PnP NDIS ou um evento de gerenciamento de energia.

Sintaxe

typedef struct _NET_PNP_EVENT_NOTIFICATION {
  NDIS_OBJECT_HEADER       Header;
  NDIS_PORT_NUMBER         PortNumber;
  NET_PNP_EVENT            NetPnPEvent;
  ULONG                    Flags;
  NDIS_NIC_SWITCH_ID       SwitchId;
  NDIS_NIC_SWITCH_VPORT_ID VPortId;
} NET_PNP_EVENT_NOTIFICATION, *PNET_PNP_EVENT_NOTIFICATION;

Membros

Header

A estrutura NDIS_OBJECT_HEADER para a estrutura NET_PNP_EVENT_NOTIFICATION. O NDIS define o membro Type da estrutura especificada por Header como NDIS_OBJECT_TYPE_DEFAULT, o membro Revision a NET_PNP_EVENT_NOTIFICATION_REVISION_1 e o membro Size a NDIS_SIZEOF_NET_PNP_EVENT_NOTIFICATION_REVISION_1.

PortNumber

A porta de origem da notificação de evento. Se a indicação status não for específica para uma porta, PortNumber será zero.

NetPnPEvent

Uma estrutura NET_PNP_EVENT que descreve o evento.

Flags

Sinalizadores para esta notificação de evento.

Importante

Para drivers de miniporto que chamam NdisMNetPnPEvent, se VPortId for definido como um valor diferente de NDIS_DEFAULT_VPORT_ID, os Sinalizadores deverão ser definidos como NET_EVENT_FLAGS_VPORT_ID_VALID para que vPortId entre em vigor.

Outros valores para Sinalizadores são reservados para NDIS.

SwitchId

Um valor NDIS_NIC_SWITCH_ID que especifica um identificador de comutador. O identificador de comutador é um inteiro entre zero e o número de opções compatíveis com o adaptador de rede. Um valor NDIS_DEFAULT_SWITCH_ID indica o comutador de adaptador de rede padrão.

VPortId

Um valor NDIS_NIC_SWITCH_VPORT_ID que identifica exclusivamente a VPort (porta virtual) no adaptador de rede.

Um valor de NDIS_DEFAULT_VPORT_ID especifica o VPort padrão na opção. O VPort padrão é sempre anexado à PF (Função Física) PCI Express (PCIe) do adaptador de rede.

Observação

Um VPort não padrão com o valor VPortId especificado deve ter sido criado anteriormente por meio de uma solicitação de método OID de OID_NIC_SWITCH_CREATE_VPORT.

Comentários

Quando o sistema operacional emite um evento PnP do sistema ou um evento de gerenciamento de energia para um objeto de dispositivo de destino que representa um adaptador, o NDIS converte o evento em uma estrutura NET_PNP_EVENT_NOTIFICATION.

O membro NetPnPEvent é uma estrutura NET_PNP_EVENT . O membro NetEvent dessa estrutura NET_PNP_EVENT especifica um código de evento que identifica o evento PnP de rede, o evento PnP do NDIS ou o evento de gerenciamento de energia.

O membro Buffer , que está na estrutura NET_PNP_EVENT especificada no membro NetPnPEvent do NET_PNP_EVENT_NOTIFICATION, especifica o endereço de um buffer que contém informações específicas para o evento indicado pelo membro NetEvent .

O NDIS também emite notificações de evento PnP para eventos PnP do NDIS, como NetEventPause, NetEventRestart, NetEventPortActivation e NetEventPortDeactivation.

O NDIS passa um ponteiro para uma estrutura NET_PNP_EVENT_NOTIFICATION para a função FilterNetPnPEvent de drivers de filtro sobrepostos e para a função ProtocolNetPnPEvent de drivers de protocolo sobrepostos.