NDIS_SWITCH_PARAMETERS構造体 (ntddndis.h)

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

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

構文

typedef struct _NDIS_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    Flags;
  NDIS_SWITCH_NAME         SwitchName;
  NDIS_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  UINT32                   NumSwitchPorts;
  BOOLEAN                  IsActive;
} NDIS_SWITCH_PARAMETERS, *PNDIS_SWITCH_PARAMETERS;

メンバーズ

Header

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

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

NDIS_SWITCH_PARAMETERS_REVISION_1

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

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

Flags

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

SwitchName

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

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

SwitchFriendlyName

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

NumSwitchPorts

拡張可能スイッチで構成されているポートの数を指定する UINT32 値。

IsActive

TRUE の場合は、拡張可能スイッチのアクティブ化 Hyper-V が終了し、ポート、NIC、プロパティの列挙など、他のスイッチ構成を照会しても安全であることを示すブール値。 FALSE の場合、拡張機能は、スイッチ構成のクエリを実行する前に、NetEventSwitchActivate PNP イベントが発行されるまで待機する必要があります。

備考

NDIS_SWITCH_PARAMETERS 構造体は、OID_SWITCH_PARAMETERSの OID 要求で使用されます。

この構造体は、Windows フィルタープラットフォームの吹き出しドライバーの次の吹き出し関数の vSwitch パラメーターにも渡されます。

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

必要条件

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

次の方法で共有

NDIS_SWITCH_PARAMETERS構造体 (ntddndis.h)

構文

メンバーズ

NDIS_SWITCH_PARAMETERS_REVISION_1

備考

必要条件

関連項目

フィードバック

その他のリソース