次の方法で共有


NDIS_SWITCH_PORT_PROPERTY_PROFILE 構造体 (ntddndis.h)

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

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

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

要件

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

こちらもご覧ください

IF_COUNTED_STRING

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS

OID_SWITCH_NIC_CREATE

OID_SWITCH_PORT_PROPERTY_ADD

OID_SWITCH_PORT_PROPERTY_UPDATE