NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 構造体 (ntddndis.h)

[アーティクル]
08/07/2023

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS構造体は、Hyper-V 拡張可能スイッチポートのポリシープロパティの配列を指定します。配列内の各要素は、 NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO 構造体として書式設定されます。

構文

typedef struct _NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_PROPERTY_TYPE           PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FirstPropertyOffset;
  ULONG                                    NumProperties;
  USHORT                                   Reserved;
} NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS;

メンバー

Header

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS構造体の型、リビジョン、およびサイズ。このメンバーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。

Header の Type メンバーは、NDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。 NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS構造体のバージョンを指定するには、Header の Revision メンバーを次の値に設定する必要があります。

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_REVISION_1

NDIS 6.30 以降の元のバージョン。

Size メンバーをNDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_REVISION_1に設定します。

Flags

フラグのビットごとの OR を含む ULONG 値。このメンバーは NDIS 用に予約されています。

PortId

プロパティが列挙される拡張可能スイッチポートの一意識別子を含むNDIS_SWITCH_PORT_ID値。

PropertyType

ポートプロパティの種類を指定する NDIS_SWITCH_PORT_PROPERTY_TYPE 列挙値。 OID_SWITCH_PORT_PROPERTY_ENUMの OID メソッド要求が発行されると、拡張可能スイッチ拡張機能は、このプロパティの種類に一致するポートプロパティを返します。

PropertyId

拡張可能スイッチポートのプロパティを識別する GUID 値。

SerializationVersion

シリアル化されたポートプロパティデータの形式バージョンを識別するNDIS_SWITCH_OBJECT_SERIALIZATION_VERSION値。このデータは、プロパティを定義したマネージドオブジェクト形式 (MOF) ファイルから拡張機能によってアクセスするためにシリアル化されます。

メモWindows Server 2012の場合、SerializationVersion メンバーをNDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1に設定する必要があります。

FirstPropertyOffset

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS構造体に続く最初のNDIS_SWITCH_PORT_PROPERTY_ENUM_INFO要素へのオフセットをバイト単位で指定する USHORT 値。オフセットは、 NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 構造体の先頭から配列の最初の要素の先頭まで測定されます。

メモNumProperties の値が 0 の場合、このメンバーは無視されます。

NumProperties

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS構造体に続くNDIS_SWITCH_PORT_PROPERTY_ENUM_INFO要素の数を指定する ULONG 値。

Reserved

将来利用するために予約されています。

注釈

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS構造体は、OID_SWITCH_PORT_PROPERTY_ENUMの OID メソッド要求で使用されます。 NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO構造体の配列は、これらの OID セット要求に関連付けられている情報バッファー内のNDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS構造体に従います。 NDIS_OID_REQUEST構造体の InformationBuffer メンバーには、この情報バッファーへのポインターが含まれています。

拡張可能スイッチ拡張機能は、 NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_GET_FIRST_INFO マクロを使用して 、NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 構造体で指定された最初の NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO構造体にアクセスできます。

拡張可能スイッチポリシーの詳細については、「 Hyper-V 拡張可能スイッチポリシー」を参照してください。