struttura NDIS_SWITCH_NIC_OID_REQUEST (ntddndis.h)

Articolo
05/23/2024

La struttura NDIS_SWITCH_NIC_OID_REQUEST specifica le informazioni necessarie per inoltrare o originare richieste OID.

Sintassi

typedef struct _NDIS_SWITCH_NIC_OID_REQUEST {
  NDIS_OBJECT_HEADER    Header;
  ULONG                 Flags;
  NDIS_SWITCH_PORT_ID   SourcePortId;
  NDIS_SWITCH_NIC_INDEX SourceNicIndex;
  NDIS_SWITCH_PORT_ID   DestinationPortId;
  NDIS_SWITCH_NIC_INDEX DestinationNicIndex;
  PNDIS_OID_REQUEST     OidRequest;
} NDIS_SWITCH_NIC_OID_REQUEST, *PNDIS_SWITCH_NIC_OID_REQUEST;

Members

Header

Tipo, revisione e dimensioni della struttura NDIS_SWITCH_NIC_OID_REQUEST . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il membro Type di Header deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT. Per specificare la versione della struttura NDIS_SWITCH_NIC_OID_REQUEST , il membro Revision di Header deve essere impostato sul valore seguente:

NDIS_SWITCH_NIC_OID_REQUEST_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NDIS_SWITCH_NIC_OID_REQUEST_REVISION_1.

Flags

Valore ULONG che contiene un OR bit per bit di flag. Questo membro è riservato per NDIS.

SourcePortId

Valore NDIS_SWITCH_PORT_ID che contiene l'identificatore univoco della porta del commutatore estendibile Hyper-V a cui è stata originariamente eseguita la richiesta OID.

SourceNicIndex

Valore NDIS_SWITCH_NIC_INDEX che specifica l'indice della scheda di rete di origine connessa alla porta del commutatore estendibile di origine specificata dal membro SourcePortId .

DestinationPortId

Valore NDIS_SWITCH_PORT_ID che contiene l'identificatore univoco della porta del commutatore estendibile a cui deve essere inoltrata la richiesta OID.

DestinationNicIndex

Valore NDIS_SWITCH_NIC_INDEX che specifica l'indice della scheda di rete di destinazione connessa alla porta del commutatore estendibile specificata dal membro DestinationPortId .

OidRequest

Puntatore a una struttura NDIS_OID_REQUEST . Questa struttura contiene i dati per la richiesta OID che verranno inoltrati al driver miniport della scheda di rete specificata dai membri DestinationPortId e DestinationNicIndex .

Commenti

La struttura NDIS_SWITCH_NIC_OID_REQUEST viene usata nelle richieste di metodi OID di OID_SWITCH_NIC_REQUEST.

Un'estensione può inoltrare o originare richieste OID alle schede di rete fisiche sottostanti nello stack di driver del commutatore estendibile. Ciò consente a un'estensione di eseguire le operazioni seguenti:

Gestire la configurazione degli offload hardware in una scheda fisica sottostante per le tecnologie di offload seguenti:
- Sicurezza del protocollo Internet (IPsec).
- Coda di macchine virtualizzate (VMQ).
- Single Root I/O Virtualization (SR-IOV).
Eseguire una query sulla configurazione di una scheda di rete fisica sottostante emettendo ID NDIS standard. Ad esempio, l'estensione può inviare una richiesta di query OID di OID_802_3_CURRENT_ADDRESS per ottenere l'indirizzo MAC (Media Access Control) corrente dell'adattatore.

Per linee guida su come inviare richieste OID alle schede fisiche sottostanti, vedere Gestione delle richieste OID alle schede di rete fisiche.