NDIS_SWITCH_PARAMETERS struttura (ntddndis.h)

Articolo
02/27/2024

La struttura NDIS_SWITCH_PARAMETERS contiene i dati di configurazione per un commutatore estendibile Hyper-V.

Sintassi

typedef struct _NDIS_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    Flags;
  NDIS_SWITCH_NAME         SwitchName;
  NDIS_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  UINT32                   NumSwitchPorts;
  BOOLEAN                  IsActive;
} NDIS_SWITCH_PARAMETERS, *PNDIS_SWITCH_PARAMETERS;

Members

Header

Tipo, revisione e dimensione della struttura NDIS_SWITCH_PARAMETERS . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

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

NDIS_SWITCH_PARAMETERS_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NDIS_SWITCH_PARAMETERS_REVISION_1.

Flags

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

SwitchName

Valore NDIS_SWITCH_NAME che specifica il nome interno univoco del commutatore estendibile.

Il nome del commutatore interno viene usato dalle applicazioni di gestione dei criteri basate su WMI. Per altre informazioni, vedere Gestione dei criteri di commutatore estendibile Hyper-V.

SwitchFriendlyName

Valore NDIS_SWITCH_FRIENDLYNAME che specifica la descrizione descrittiva dell'commutatore estendibile.

NumSwitchPorts

Valore UINT32 che specifica il numero di porte configurate nel commutatore estendibile.

IsActive

VALORE BOOLEAN che se TRUE indica che l'attivazione del commutatore estendibile Hyper-V è stata completata ed è sicura eseguire query per altre configurazioni di commutatori, ad esempio l'enumerazione di porte, schede di interfaccia di rete e proprietà. Se FALSE, l'estensione deve attendere l'emissione dell'evento PNP NetEventSwitchActivate prima di eseguire query sulla configurazione del commutatore.

Commenti

La struttura NDIS_SWITCH_PARAMETERS viene usata nella richiesta OID di OID_SWITCH_PARAMETERS.

Questa struttura viene passata anche nel parametro vSwitch delle seguenti funzioni di callout per i driver callout di Windows Filtering Platform:

Nota I tipi di dati NDIS_SWITCH_NAME e NDIS_SWITCH_FRIENDLYNAME sono definiti dalla struttura IF_COUNTED_STRING . Una stringa definita da questa struttura non deve essere terminata con null. Tuttavia, la lunghezza della stringa deve essere impostata nel membro Length di questa struttura. Se la stringa è terminata con valore Null, il membro Length non deve includere il carattere Null terminante.