struttura NET_PNP_EVENT_NOTIFICATION (ndis.h)
La struttura NET_PNP_EVENT_NOTIFICATION descrive un evento di rete Plug and Play (PnP), un evento NDIS PnP o un evento di risparmio energia.
Sintassi
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;
Members
Header
Struttura NDIS_OBJECT_HEADER per la struttura NET_PNP_EVENT_NOTIFICATION. NDIS imposta il membro Type della struttura specificata da Header su NDIS_OBJECT_TYPE_DEFAULT, il membro Revision su NET_PNP_EVENT_NOTIFICATION_REVISION_1 e il membro Size su NDIS_SIZEOF_NET_PNP_EVENT_NOTIFICATION_REVISION_1.
PortNumber
Porta di origine della notifica degli eventi. Se l'indicazione dello stato non è specifica per una porta, PortNumber è zero.
NetPnPEvent
Struttura NET_PNP_EVENT che descrive l'evento.
Flags
Flag per questa notifica degli eventi.
Importante
Per i driver miniport che chiamano NdisMNetPnPEvent, se VPortId è impostato su un valore diverso da NDIS_DEFAULT_VPORT_ID, i flag devono essere impostati su NET_EVENT_FLAGS_VPORT_ID_VALID per rendere effettivo VPortId .
Altri valori per Flag sono riservati per NDIS.
SwitchId
Valore NDIS_NIC_SWITCH_ID che specifica un identificatore di opzione. L'identificatore del commutatore è un numero intero compreso tra zero e il numero di commutatori supportati dalla scheda di rete. Un valore NDIS_DEFAULT_SWITCH_ID indica il commutatore della scheda di rete predefinito.
VPortId
Valore NDIS_NIC_SWITCH_VPORT_ID che identifica in modo univoco la porta virtuale (VPort) nella scheda di rete.
Il valore di NDIS_DEFAULT_VPORT_ID specifica il VPort predefinito sull'opzione. Il VPort predefinito è sempre collegato alla funzione fisica PCI Express (PCIe) della scheda di rete.
Nota
Un VPort non predefinito con il valore VPortId specificato deve essere stato creato in precedenza tramite una richiesta di metodo OID di OID_NIC_SWITCH_CREATE_VPORT.
Commenti
Quando il sistema operativo rilascia un evento PnP di sistema o un evento di risparmio energia a un oggetto dispositivo di destinazione che rappresenta un adattatore, NDIS converte l'evento in una struttura NET_PNP_EVENT_NOTIFICATION.
Il membro NetPnPEvent è una struttura NET_PNP_EVENT . Il membro NetEvent di questa struttura NET_PNP_EVENT specifica un codice evento che identifica l'evento PnP di rete, l'evento NDIS PnP o l'evento di risparmio energia.
Il membro Buffer , che si trova nella struttura NET_PNP_EVENT specificata nel membro NetPnPEvent di NET_PNP_EVENT_NOTIFICATION, specifica l'indirizzo di un buffer contenente informazioni specifiche dell'evento indicato dal membro NetEvent .
NDIS genera anche notifiche degli eventi PnP per eventi NDIS PnP, ad esempio NetEventPause, NetEventRestart, NetEventPortActivation e NetEventPortDeactivation.
NDIS passa un puntatore a una struttura NET_PNP_EVENT_NOTIFICATION alla funzione FilterNetPnPEvent di driver di filtro eccessivo e alla funzione ProtocolNetPnPEvent di driver di protocollo overlying.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato in NDIS 6.0 e versioni successive. |
| Intestazione | ndis.h (include Ndis.h) |