NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO-Struktur (ntddndis.h)

Artikel
02/29/2024

Die NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO-Struktur enthält Informationen zu einer hyper-V erweiterbaren Switchport-Richtlinieneigenschaft.

Syntax

typedef struct _NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO {
  NDIS_OBJECT_HEADER             Header;
  ULONG                          Flags;
  NDIS_SWITCH_OBJECT_VERSION     PropertyVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID PropertyInstanceId;
  ULONG                          QwordAlignedPropertyBufferLength;
  ULONG                          PropertyBufferLength;
  ULONG                          PropertyBufferOffset;
} NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO, *PNDIS_SWITCH_PORT_PROPERTY_ENUM_INFO;

Member

Header

Der Typ, die Revision und die Größe der NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO Struktur. Dieses Element ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Das Type-Element von Header muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden. Um die Version der NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO-Struktur anzugeben, muss der Revisionsmember von Header auf den folgenden Wert festgelegt werden:

NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO_REVISION_1

Ursprüngliche Version für NDIS 6.30 und höher.

Legen Sie das Element Größe auf NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_REVISION_1 fest.

Flags

Ein ULONG-Wert, der ein bitweises OR von Flags enthält. Dieses Element ist für NDIS reserviert.

PropertyVersion

Ein NDIS_SWITCH_OBJECT_VERSION Wert, der die Version der Eigenschaft für den erweiterbaren Switchport angibt.

PropertyInstanceId

Ein NDIS_SWITCH_OBJECT_INSTANCE_ID Wert, der den instance Bezeichner für die erweiterbare Switchporteigenschaft angibt.

QwordAlignedPropertyBufferLength

Ein ULONG-Wert, der die ausgerichtete Größe des Eigenschaftspuffers in Bytes angibt.

PropertyBufferLength

Ein ULONG-Wert, der die tatsächliche Größe des Eigenschaftenpuffers in Bytes angibt.

Hinweis Dieser Wert muss kleiner oder gleich dem Wert des QwordAlignedPropertyBufferLength-Elements sein.

PropertyBufferOffset

Ein ULONG-Wert, der den Offset in Bytes auf den Eigenschaftenpuffer angibt, der der NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO-Struktur folgt. Der Offset wird vom Anfang der NDIS_SWITCH_PORT_PROPERTY_PARAMETERS-Struktur bis zum Anfang des Eigenschaftspuffers gemessen.

Hinweise

Die NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO-Struktur wird in OID-Methodenanforderungen von OID_SWITCH_PORT_PROPERTY_ENUM verwendet. Ein Array von NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO Strukturen folgt der NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS-Struktur im Informationspuffer, der dieser OID-Anforderung zugeordnet ist. Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf diesen Informationspuffer.

Erweiterbare Switcherweiterungen können mithilfe des makros NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO_GET_NEXT auf das nächste NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO-Element zugreifen, das einer NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO Struktur im Array folgt.

Erweiterbare Switcherweiterungen können mithilfe des makros NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO_GET_PROPERTY auf den Porteigenschaftenpuffer zugreifen, der von einer NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO-Struktur angegeben wird.

Weitere Informationen zu erweiterbaren Switchrichtlinien finden Sie unter Hyper-V Extensible Switch Policies.