NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS 構造体 (ntddndis.h)

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

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS構造体は、Hyper-V 拡張可能スイッチポートのカスタム状態情報のパラメーターを指定します。この情報は 、機能の状態 情報と呼ばれます。この情報の形式は、独立系ソフトウェアベンダー (ISV) によって定義されます。

状態情報は、NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM 構造体を介して指定され、 OID_SWITCH_PORT_FEATURE_STATUS_QUERYの OID メソッド要求を通じて返されます。

構文

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;

メンバー

Header

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

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

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS_REVISION_1

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

[サイズ] メンバーを [NDIS_SIZEOF_NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS_REVISION_1] に設定します。

Flags

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

PortId

拡張可能スイッチポートの数値識別子を指定するNDIS_SWITCH_PORT_ID値。この値は、機能の状態情報を返す拡張可能スイッチのポートを一意に識別します。

FeatureStatusType

カスタム拡張可能スイッチポートプロファイルプロパティの状態情報の種類を指定する NDIS_SWITCH_PORT_FEATURE_STATUS_TYPE列挙値。

メモ NDIS 6.30 以降では、このメンバーを NdisSwitchPortPropertyTypeCustom に設定する必要があります。

FeatureStatusId

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

FeatureStatusVersion

拡張可能スイッチポートのプロファイルプロパティのバージョンを識別するNDIS_SWITCH_OBJECT_VERSION値。

SerializationVersion

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

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

FeatureStatusInstanceId

拡張可能スイッチポートの機能状態情報のインスタンスを識別するNDIS_SWITCH_OBJECT_INSTANCE_ID値。

FeatureStatusBufferLength

機能状態バッファーのサイズをバイト単位で指定する ULONG 値。

FeatureStatusBufferOffset

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS構造体に続く機能状態バッファーへのオフセットをバイト単位で指定する ULONG 値。機能状態バッファーには、 NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM 構造体が含まれています。

オフセットは、 NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS 構造体の先頭から NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM 構造体の先頭まで測定されます。

Reserved

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

注釈

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS構造体は、OID_SWITCH_PORT_FEATURE_STATUS_QUERYの OID メソッド要求で使用されます。この OID 要求は、OID 要求に関連付けられている情報バッファー内の次の構造体を返します。

状態情報を返す拡張可能スイッチポートのカスタムプロパティのパラメーターを指定するNDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS構造体。 スイッチ拡張機能は、構造体の FeatureStatusVersion メンバーに、NDIS_SWITCH_FEATURE_STATUS_CUSTOM バッファーで返されるカスタム状態のバージョンを反映するように設定します。 Hyper-v 拡張可能スイッチは、クエリ OID の発行時に他のすべてのメンバーを設定します。
拡張可能スイッチポートプロパティの状態情報を含む NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM 構造体。スイッチ拡張機能は、返されるカスタム状態のサイズを反映するために、構造体の FeatureStatusCustomBufferLength メンバーを設定します。 Hyper-v 拡張可能スイッチは、クエリ OID の発行時に他のすべてのメンバーを設定します。