次の方法で共有


NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 構造体 (ntddndis.h)

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS構造体は、Hyper-V 拡張可能スイッチ ポートのポリシー プロパティのパラメーターを指定します。

構文

typedef struct _NDIS_SWITCH_PORT_PROPERTY_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_VERSION               PropertyVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           PropertyInstanceId;
  ULONG                                    PropertyBufferLength;
  ULONG                                    PropertyBufferOffset;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_PROPERTY_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_PARAMETERS;

メンバー

Header

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

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

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1

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

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

Flags

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

PortId

プロパティが割り当てられている拡張可能スイッチ ポートの一意識別子を含むNDIS_SWITCH_PORT_ID値。

PropertyType

プロパティ バッファー内に含まれるポート プロパティの種類を指定するNDIS_SWITCH_PORT_PROPERTY_TYPE列挙値。

PropertyId

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

詳細については、「解説」を参照してください。

メモ 拡張可能スイッチ拡張機能は、 PropertyType メンバーが NdisSwitchPortPropertyTypeCustom に設定されていない限り、このメンバーを無視する必要があります。
 

PropertyVersion

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

SerializationVersion

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

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

PropertyInstanceId

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

PropertyBufferLength

プロパティ バッファーのサイズをバイト単位で指定する ULONG 値。

PropertyBufferOffset

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS構造体に続くプロパティ バッファーへのオフセットをバイト単位で指定する ULONG 値。 オフセットは、 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 構造体の先頭からプロパティ バッファーの先頭まで測定されます。

Reserved

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

注釈

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS構造体は、次の OID セット要求で使用されます。

プロパティ バッファーには、 PropertyType メンバーに関連付けられている構造体が含まれています。 プロパティ バッファーは、これらの OID セット要求に関連付けられている情報バッファー内の NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 構造に従います。 NDIS_OID_REQUEST構造体の InformationBuffer メンバーには、この情報バッファーへのポインターが含まれています。

拡張可能スイッチ拡張機能は、 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 構造を処理するときに、次のガイドラインに従う必要があります。

  • PropertyType メンバーが NdisSwitchPortPropertyTypeSecurity に設定されている場合、プロパティ バッファーはNDIS_SWITCH_PORT_PROPERTY_SECURITY構造体として書式設定されます。
  • PropertyType メンバーが NdisSwitchPortPropertyTypeVlan に設定されている場合、プロパティ バッファーはNDIS_SWITCH_PORT_PROPERTY_VLAN構造体として書式設定されます。
  • PropertyType メンバーが NdisSwitchPortPropertyTypeProfile に設定されている場合、プロパティ バッファーはNDIS_SWITCH_PORT_PROPERTY_PROFILE構造体として書式設定されます。
  • PropertyType メンバーが NdisSwitchPortPropertyTypeCustom に設定されている場合、PropertyId メンバーは、カスタム ポート プロパティ用に作成された独立系ソフトウェア ベンダー (ISV) の GUID 値に設定する必要があります。 プロパティ バッファーは、ISV で定義されているカスタム ポート プロパティのパラメーターを含む NDIS_SWITCH_PORT_PROPERTY_CUSTOM 構造体として書式設定されます。
拡張可能スイッチ拡張機能は、NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_GET_PROPERTY マクロを使用して 、NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 構造体内のカスタム ポート プロパティ アクセスできます。

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

要件

要件
サポートされている最小のクライアント NDIS 6.30 以降でサポートされています。
Header ntddndis.h (Ndis.h、Fwpsk.h を含む)

こちらもご覧ください

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PROPERTY_CUSTOM

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_GET_PROPERTY

NDIS_SWITCH_PORT_PROPERTY_PROFILE

NDIS_SWITCH_PORT_PROPERTY_SECURITY

NDIS_SWITCH_PORT_PROPERTY_TYPE

NDIS_SWITCH_PORT_PROPERTY_VLAN

OID_SWITCH_PORT_PROPERTY_ADD

OID_SWITCH_PORT_PROPERTY_UPDATE