NET_PNP_EVENT_NOTIFICATION estrutura (ndis.h)
A estrutura NET_PNP_EVENT_NOTIFICATION descreve um evento 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 tipo da estrutura que header especifica para NDIS_OBJECT_TYPE_DEFAULT, o membro de Revisão para NET_PNP_EVENT_NOTIFICATION_REVISION_1 e o membro tamanho do para NDIS_SIZEOF_NET_PNP_EVENT_NOTIFICATION_REVISION_1.
PortNumber
A porta de origem da notificação de evento. Se a indicação de status não for específica a 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, Flags deverá ser definido como NET_EVENT_FLAGS_VPORT_ID_VALID para VPortId entrar 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 comutadores 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 porta virtual (VPort) 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 à função física PCI Express (PCIe) do adaptador de rede.
Nota
Um VPort não padrão com o valor de VPortId especificado deve ter sido criado anteriormente por meio de uma solicitação de método OID de OID_NIC_SWITCH_CREATE_VPORT.
Observações
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 netEvent membro desta estrutura NET_PNP_EVENT especifica um código de evento que identifica o evento PnP de rede, o evento NDIS PnP ou o evento de gerenciamento de energia.
O membro do Buffer, que está na estrutura de 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 do evento indicado pelo membro netevent.
O NDIS também emite notificações de evento PnP para eventos PnP do NDIS, como NetEventPause, NetEventRestart, NetEventPortActivatione 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.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte no NDIS 6.0 e posterior. |
| cabeçalho | ndis.h (inclua Ndis.h) |