NDIS_SWITCH_PORT_PROPERTY_PROFILE構造体 (ntddndis.h)

[アーティクル]
02/07/2025

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 構造体として書式設定されます。

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

NDIS_SWITCH_PORT_PROPERTY_PROFILE_REVISION_1

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

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

Flags

フラグのビットごとの または を含む 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 つのアダプターのポリシーを指定できます。拡張可能スイッチチームの詳細については、「物理ネットワークアダプター構成の種類を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	NDIS 6.30 以降でサポートされています。
ヘッダー	ntddndis.h (Ndis.h を含む)

次の方法で共有

NDIS_SWITCH_PORT_PROPERTY_PROFILE構造体 (ntddndis.h)

構文

メンバーズ

NDIS_SWITCH_PORT_PROPERTY_PROFILE_REVISION_1

備考

必要条件

関連項目

フィードバック

その他のリソース