struttura NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS (ntddndis.h)

Articolo
08/07/2023

La struttura NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS specifica i parametri per le informazioni di stato personalizzate di una porta commutatore estendibile Hyper-V. Queste informazioni sono note come informazioni sullo stato delle funzionalità . Il formato di queste informazioni è definito dal fornitore di software indipendente (ISV).

Le informazioni sullo stato vengono specificate tramite una struttura NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM e vengono restituite tramite una richiesta di metodo OID di OID_SWITCH_PORT_FEATURE_STATUS_QUERY.

Sintassi

typedef struct _NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_FEATURE_STATUS_TYPE     FeatureStatusType;
  NDIS_SWITCH_OBJECT_ID                    FeatureStatusId;
  NDIS_SWITCH_OBJECT_VERSION               FeatureStatusVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           FeatureStatusInstanceId;
  ULONG                                    FeatureStatusBufferLength;
  ULONG                                    FeatureStatusBufferOffset;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS, *PNDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS;

Members

Header

Tipo, revisione e dimensioni della struttura NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS . 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_PORT_FEATURE_STATUS_PARAMETERS , il membro Revision di Header deve essere impostato sul valore seguente:

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS_REVISION_1.

Flags

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

PortId

Valore NDIS_SWITCH_PORT_ID che specifica l'identificatore numerico per una porta del commutatore estendibile. Questo valore identifica in modo univoco la porta sull'opzione estendibile per cui devono essere restituite le informazioni sullo stato della funzionalità.

FeatureStatusType

Valore di enumerazione NDIS_SWITCH_PORT_FEATURE_STATUS_TYPE che specifica il tipo di informazioni sullo stato per una proprietà personalizzata del profilo di porta commutatore estendibile.

Nota A partire da NDIS 6.30, questo membro deve essere impostato su NdisSwitchPortPropertyTypeCustom.

FeatureStatusId

Valore NDIS_SWITCH_OBJECT_ID che identifica la proprietà del profilo per la porta del commutatore estendibile.

FeatureStatusVersion

Valore NDIS_SWITCH_OBJECT_VERSION che identifica la versione della proprietà del profilo per la porta del commutatore estendibile.

SerializationVersion

Valore NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION che identifica la versione del formato dei dati della proprietà della porta serializzata. Questi dati vengono serializzati per l'accesso dall'estensione dal file MOF (Managed Object Format) che ha definito la proprietà .

Nota Per Windows Server 2012, il membro SerializationVersion deve essere impostato su NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1.

FeatureStatusInstanceId

Valore NDIS_SWITCH_OBJECT_INSTANCE_ID che identifica l'istanza delle informazioni sullo stato della funzionalità per la porta del commutatore estendibile.

FeatureStatusBufferLength

Valore ULONG che specifica le dimensioni, in byte, del buffer di stato della funzionalità.

FeatureStatusBufferOffset

Valore ULONG che specifica l'offset, in byte, nel buffer di stato della funzionalità che segue la struttura NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS . Il buffer di stato della funzionalità contiene una struttura NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM .

L'offset viene misurato dall'inizio della struttura NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS fino all'inizio della struttura NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM .

Reserved

Riservato per utilizzi futuri.

Commenti

La struttura NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS viene usata nelle richieste del metodo OID di OID_SWITCH_PORT_FEATURE_STATUS_QUERY. Questa richiesta OID restituisce le strutture seguenti nel buffer delle informazioni associato alla richiesta OID:

Struttura NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS che specifica i parametri per una proprietà personalizzata di una porta commutatore estendibile per cui devono essere restituite le informazioni sullo stato. L'estensione switch popola il membro FeatureStatusVersion della struttura in modo da riflettere la versione dello stato personalizzato restituito nel buffer NDIS_SWITCH_FEATURE_STATUS_CUSTOM. L'opzione Estendibile Hyper-v popola tutti gli altri membri durante l'emissione dell'OID della query.
Struttura NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM che contiene le informazioni sullo stato per la proprietà della porta del commutatore estendibile. L'estensione switch popola il membro FeatureStatusCustomBufferLength della struttura per riflettere le dimensioni dello stato personalizzato restituito. L'opzione Estendibile Hyper-v popola tutti gli altri membri durante l'emissione dell'OID della query.