NDIS_SWITCH_PROPERTY_ENUM_INFO struttura (ntddndis.h)

Articolo
02/26/2024

La struttura NDIS_SWITCH_PROPERTY_ENUM_INFO specifica informazioni su una proprietà del profilo per il commutatore estendibile Hyper-V.

Sintassi

typedef struct _NDIS_SWITCH_PROPERTY_ENUM_INFO {
  NDIS_OBJECT_HEADER             Header;
  ULONG                          Flags;
  NDIS_SWITCH_OBJECT_INSTANCE_ID PropertyInstanceId;
  NDIS_SWITCH_OBJECT_VERSION     PropertyVersion;
  ULONG                          QwordAlignedPropertyBufferLength;
  ULONG                          PropertyBufferLength;
  ULONG                          PropertyBufferOffset;
} NDIS_SWITCH_PROPERTY_ENUM_INFO, *PNDIS_SWITCH_PROPERTY_ENUM_INFO;

Members

Header

Tipo, revisione e dimensione della struttura NDIS_SWITCH_PROPERTY_ENUM_INFO . 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_PROPERTY_ENUM_INFO , il membro Revision of Header deve essere impostato sul valore seguente:

NDIS_SWITCH_PROPERTY_ENUM_INFO_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1.

Flags

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

PropertyInstanceId

Valore NDIS_SWITCH_OBJECT_INSTANCE_ID che specifica l'identificatore dell'istanza della proprietà commutatore estendibile.

PropertyVersion

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

QwordAlignedPropertyBufferLength

Valore ULONG che specifica le dimensioni allineate, in byte, del buffer delle proprietà.

PropertyBufferLength

Valore ULONG che specifica le dimensioni effettive, in byte, del buffer delle proprietà.

Nota Questo valore deve essere minore o uguale al valore del membro QwordAlignedPropertyBufferLength .

PropertyBufferOffset

Valore ULONG che specifica l'offset, in byte, nel buffer delle proprietà che segue la struttura NDIS_SWITCH_PROPERTY_ENUM_INFO . L'offset viene misurato dall'inizio della struttura NDIS_SWITCH_PROPERTY_PARAMETERS fino all'inizio del buffer delle proprietà.

Commenti

La struttura NDIS_SWITCH_PROPERTY_ENUM_INFO viene usata nelle richieste del set OID di OID_SWITCH_PROPERTY_ENUM. Una matrice di strutture NDIS_SWITCH_PROPERTY_ENUM_INFO segue la struttura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS nel buffer delle informazioni associato a queste richieste di set OID. Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a questo buffer di informazioni.

Le estensioni del commutatore estendibile possono accedere all'elemento NDIS_SWITCH_PROPERTY_ENUM_INFO successivo che segue una struttura NDIS_SWITCH_PROPERTY_ENUM_INFO nella matrice usando la macro NDIS_SWITCH_PROPERTY_ENUM_INFO_GET_NEXT.

Le estensioni del commutatore estendibile possono accedere al buffer delle proprietà di commutatore estendibile specificato da una struttura NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO usando la macro NDIS_SWITCH_PROPERTY_ENUM_INFO_GET_PROPERTY .

Per altre informazioni sui criteri di commutatore estendibili, vedere Criteri di commutatore estendibile Hyper-V.