NDIS_SWITCH_PORT_PARAMETERS 構造体 (ntddndis.h)

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

NDIS_SWITCH_PORT_PARAMETERS構造体には、Hyper-V 拡張可能スイッチポートの構成データが含まれています。

構文

typedef struct _NDIS_SWITCH_PORT_PARAMETERS {
  NDIS_OBJECT_HEADER            Header;
  ULONG                         Flags;
  NDIS_SWITCH_PORT_ID           PortId;
  NDIS_SWITCH_PORT_NAME         PortName;
  NDIS_SWITCH_PORT_FRIENDLYNAME PortFriendlyName;
  NDIS_SWITCH_PORT_TYPE         PortType;
  BOOLEAN                       IsValidationPort;
  NDIS_SWITCH_PORT_STATE        PortState;
} NDIS_SWITCH_PORT_PARAMETERS, *PNDIS_SWITCH_PORT_PARAMETERS;

メンバー

Header

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

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

NDIS_SWITCH_PORT_PARAMETERS_REVISION_1

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

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

Flags

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

PortId

拡張可能スイッチポートの一意識別子を含むNDIS_SWITCH_PORT_ID値。

PortName

拡張可能スイッチポートの一意の内部名を指定するNDIS_SWITCH_PORT_NAME値。

内部ポート名は、WMI ベースのポリシー管理アプリケーションで使用されます。詳細については、「 Hyper-V 拡張可能スイッチポリシーの管理」を参照してください。

PortFriendlyName

拡張可能スイッチポートのわかりやすい説明を指定するNDIS_SWITCH_PORT_FRIENDLYNAME値。

PortType

拡張可能スイッチポートの種類を指定するNDIS_SWITCH_PORT_TYPE値。

IsValidationPort

TRUE の場合、は、VM ネットワークアダプター接続が確立される前に、テストおよび検証のために一時的に作成されるポートを示します。このポートの種類の詳細については、「検証ポート」を参照してください。

PortState

ポートの現在の状態を指定するNDIS_SWITCH_PORT_STATE値。

注釈

NDIS_OID_REQUEST構造体の InformationBuffer メンバーには、次の OID 要求のNDIS_SWITCH_PORT_PARAMETERS構造体へのポインターが含まれています。

OID_SWITCH_PORT_ARRAY の OID クエリ要求は、要素の配列を含む NDIS_SWITCH_PORT_ARRAY 構造体を返します。各要素は、 NDIS_SWITCH_PORT_PARAMETERS 構造体として書式設定されます。

拡張可能スイッチ拡張機能は、NDIS_SWITCH_PORT_AT_ARRAY_INDEX マクロを使用して、NDIS_SWITCH_PORT_PARAMETERS構造体内のポートプロパティバッファーにアクセスできます。

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

要件

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