NDIS_SWITCH_PORT_PROPERTY_PROFILE 構造体 (ntddndis.h)

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

NDIS_SWITCH_PORT_PROPERTY_PROFILE構造体は、拡張可能スイッチ拡張機能が Hyper-V ポリシーストアではなく独自のポリシーストアに保存する Hyper-V 拡張可能スイッチポートのポリシープロパティを指定します。この場合、ポリシー定義は、ドライバーのポリシーストア内のプロパティプロファイルによって識別されます。

構文

typedef struct _NDIS_SWITCH_PORT_PROPERTY_PROFILE {
  NDIS_OBJECT_HEADER                          Header;
  ULONG                                       Flags;
  NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME      ProfileName;
  GUID                                        ProfileId;
  NDIS_VENDOR_NAME                            VendorName;
  GUID                                        VendorId;
  UINT32                                      ProfileData;
  GUID                                        NetCfgInstanceId;
  struct {
    UINT32 PciSegmentNumber : 16;
    UINT32 PciBusNumber : 8;
    UINT32 PciDeviceNumber : 5;
    UINT32 PciFunctionNumber : 3;
  } PciLocation;
  UINT32                                      CdnLabelId;
  NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL CdnLabel;
} NDIS_SWITCH_PORT_PROPERTY_PROFILE, *PNDIS_SWITCH_PORT_PROPERTY_PROFILE;

メンバー

Header

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

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

NDIS_SWITCH_PORT_PROPERTY_PROFILE_REVISION_1

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

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

Flags

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

ProfileName

プロファイルプロパティのわかりやすい名前を指定するNDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME値。

ProfileId

プロファイルプロパティを一意に識別する GUID 値。

VendorName

ポートプロファイルを定義したベンダーのわかりやすい名前を指定するNDIS_VENDOR_NAME値。

VendorId

ポートプロファイルを定義したベンダーを識別する GUID 値。

ProfileData

NetCfgInstanceId

プロパティが適用される基になるネットワークアダプター接続の NetCfgInstanceId レジストリ値を指定する GUID 値。

NetCfgInstanceId 値は、OID_SWITCH_NIC_CREATEのオブジェクト識別子 (OID) セット要求を介してネットワークアダプター接続に指定されます。

PciLocation

NetCfgInstanceId メンバーによって指定される、基になる物理ネットワークアダプターの PCI の場所を指定する構造体。

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

PciLocation.PciSegmentNumber

物理ネットワークアダプターが接続されている PCI バスのグループを示す値です。

PciLocation.PciBusNumber

物理ネットワークアダプターが接続されている現在の PCI バス番号を示す値です。

PciLocation.PciDeviceNumber

PCI バス上の物理ネットワークアダプターのデバイス番号を示す値です。

メモ PCI デバイス番号は、 PCI スロット番号とも呼ばれます。

PciLocation.PciFunctionNumber

物理ネットワークアダプター上の論理デバイスの関数番号を示す値です。

CdnLabelId

CdnLabel メンバーに含まれるデータの一意識別子を指定する UINT32 値。

CdnLabel

物理ネットワークアダプターの場所の PCI Express (PCIe) CDN ラベルを指定するNDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL値。 CDN ラベルは、同様のハードウェアの場所間で一貫したデバイスの場所を提供します。

注釈

NDIS_SWITCH_PORT_PROPERTY_PROFILE構造は、Hyper-V ポリシーストアではなく、プライベートポリシーストア内のポリシープロパティを参照するために拡張機能によって使用されます。これにより、独立系ソフトウェアベンダー (ISV) は、プライベートチャネルとインターフェイスを介してこのプライベートポリシーストアを設定および管理できます。ベンダーは、 VendorName フィールドと VendorId フィールドを使用して、プロファイルを他のベンダーのプロファイルと区別できます。

メモNDIS_SWITCH_PORT_PROPERTY_PROFILE構造体で指定されたポートポリシープロパティは、拡張可能スイッチインターフェイスに対して透過的です。

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

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

メモNDIS_SWITCH_PORT_PROPERTY_PROFILE_NAMEおよびNDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABELデータ型は、IF_COUNTED_STRING構造体によって型定義されます。この構造体で定義されている文字列は、null で終わる必要はありません。ただし、文字列の長さは、この構造体の Length メンバーで設定する必要があります。文字列が null で終わる場合、 Length メンバーは終端の null 文字を含めてはなりません。

PciLocation メンバーと CdnLabel メンバーは、プロパティプロファイルが拡張可能スイッチ外部ネットワークアダプターに接続されている基になる物理ネットワークアダプターのポリシーを指定している場合にのみ関連します。たとえば、外部ネットワークアダプターがアダプターの拡張可能スイッチチームにバインドされている場合、これらのメンバーは、そのチームの 1 つのアダプターのポリシーを指定できます。拡張可能スイッチチームの詳細については、「物理ネットワークアダプター構成の種類」を参照してください。