struttura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS (ntddndis.h)

Articolo
08/07/2023

La struttura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS specifica i parametri per le informazioni di stato personalizzate di un 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_FEATURE_STATUS_CUSTOM restituita tramite una richiesta del metodo OID (Object Identifier) di OID_SWITCH_FEATURE_STATUS_QUERY.

Sintassi

typedef struct _NDIS_SWITCH_FEATURE_STATUS_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_FEATURE_STATUS_TYPE          FeatureStatusType;
  NDIS_SWITCH_OBJECT_ID                    FeatureStatusId;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           FeatureStatusInstanceId;
  NDIS_SWITCH_OBJECT_VERSION               FeatureStatusVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FeatureStatusBufferOffset;
  ULONG                                    FeatureStatusBufferLength;
} NDIS_SWITCH_FEATURE_STATUS_PARAMETERS, *PNDIS_SWITCH_FEATURE_STATUS_PARAMETERS;

Members

Header

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

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1.

Flags

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

FeatureStatusType

Valore di enumerazione NDIS_SWITCH_FEATURE_STATUS_TYPE che specifica il tipo di informazioni sullo stato della funzionalità per l'opzione estendibile.

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

FeatureStatusId

Valore GUID che identifica le informazioni sullo stato della funzionalità per l'opzione estendibile.

Questo valore viene definito nella definizione della classe MOF (Managed Object Format) per le informazioni sullo stato della funzionalità. Per altre informazioni, vedere Custom Switch Property Definition and Registration.For more information, see Custom Switch Property Definition and Registration.

FeatureStatusInstanceId

Valore NDIS_SWITCH_OBJECT_INSTANCE_ID che identifica l'istanza delle informazioni sullo stato della funzionalità per l'opzione estendibile.

FeatureStatusVersion

Valore NDIS_SWITCH_OBJECT_VERSION che identifica la versione delle informazioni sullo stato della funzionalità per l'opzione estendibile. Questo valore viene definito nella definizione della classe MOF per le informazioni sullo stato della funzionalità.

SerializationVersion

Valore NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION che identifica la versione del formato delle informazioni sullo stato serializzate per le informazioni sullo stato della funzionalità. Questi dati vengono serializzati per l'accesso dall'estensione dal file MOF che ha definito la proprietà .

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

FeatureStatusBufferOffset

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

L'offset viene misurato dall'inizio della struttura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS fino all'inizio della struttura NDIS_SWITCH_FEATURE_STATUS_CUSTOM .

FeatureStatusBufferLength

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

Commenti

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

Struttura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS che specifica i parametri di stato per le informazioni sullo stato della funzionalità dell'opzione estendibile. 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_FEATURE_STATUS_CUSTOM che contiene le informazioni sullo stato della funzionalità per l'opzione 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.