NDIS_SWITCH_NIC_SAVE_STATE 構造体 (ntddndis.h)

  • [アーティクル]

NDIS_SWITCH_NIC_SAVE_STATE構造体は、Hyper-V 拡張可能スイッチ ポートの実行時の状態情報を指定します。 拡張可能スイッチ拡張機能では、この構造体を使用して、実行時のポート情報を保存または復元します。

構文

typedef struct _NDIS_SWITCH_NIC_SAVE_STATE {
  NDIS_OBJECT_HEADER                 Header;
  ULONG                              Flags;
  NDIS_SWITCH_PORT_ID                PortId;
  NDIS_SWITCH_NIC_INDEX              NicIndex;
  GUID                               ExtensionId;
  NDIS_SWITCH_EXTENSION_FRIENDLYNAME ExtensionFriendlyName;
  GUID                               FeatureClassId;
  USHORT                             SaveDataSize;
  USHORT                             SaveDataOffset;
  ULONG                              SaveDataSizeOverflow;
} NDIS_SWITCH_NIC_SAVE_STATE, *PNDIS_SWITCH_NIC_SAVE_STATE;

メンバー

Header

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

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

NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1

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

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

Flags

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

PortId

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

NicIndex

ネットワーク アダプターの Nic インデックスを含むNDIS_SWITCH_NIC_INDEX値。 この値は常に 0 になります。 詳細については、「 ネットワーク アダプターのインデックス値」を参照してください。

ExtensionId

拡張可能スイッチ拡張機能を識別する GUID 値。

ExtensionFriendlyName

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

FeatureClassId

保存されたデータに関連するフィーチャクラスの識別子を含む GUID 値。 フィーチャクラス識別子は、ランタイム データのコンポーネントを一意に識別するために拡張機能によって定義されます。

メモ このメンバーは省略可能です。 保存されたデータにフィーチャクラスがない場合は、拡張可能スイッチ拡張機能でこのメンバーを 0 に設定する必要があります。
 

SaveDataSize

SaveData メンバーに含まれるデータのサイズをバイト単位で指定した USHORT 値。

メモ この値は、NDIS_SWITCH_NIC_SAVE_STATE_MAX_DATA_SIZE以下である必要があります。
 

SaveDataOffset

構造体の先頭から、保存または復元される実行時の状態情報までのオフセットを含む USHORT 値。

SaveDataSizeOverflow

注釈

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

メモ NDIS_SWITCH_EXTENSION_FRIENDLYNAMEデータ型は、 IF_COUNTED_STRING 構造体によって型定義されます。 この構造体で定義されている文字列は、null で終わる必要はありません。 ただし、文字列の長さは、この構造体の Length メンバーで設定する必要があります。 文字列が null で終わる場合、 Length メンバーは終端の null 文字を含めてはなりません。
 
ランタイム ポート情報を保存または復元する方法の詳細については、「 Manageing Hyper-V Extensible Switch Run-Time Data」を参照してください。

要件

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

こちらもご覧ください

IF_COUNTED_STRING

NDIS_OBJECT_HEADER

OID_SWITCH_NIC_RESTORE

OID_SWITCH_NIC_SAVE

OID_SWITCH_NIC_SAVE_COMPLETE