estrutura NET_PNP_EVENT_NOTIFICATION (ndis.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte no NDIS 6.0 e posterior. |
| Cabeçalho | ndis.h (inclua Ndis.h) |