OID_SWITCH_NIC_RESTORE
Hyper-V 拡張可能スイッチのプロトコル エッジは、拡張可能スイッチ ポートとそのネットワーク アダプター接続用に復元できるランタイム データについて拡張可能スイッチ拡張機能に通知するために、OID_SWITCH_NIC_RESTORE のオブジェクト識別子 (OID) セット要求を発行します。
NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、 NDIS_SWITCH_NIC_SAVE_STATE 構造体を指すポインターが含まれています。 この構造体は、拡張可能スイッチのプロトコル エッジによって割り当てられます。
解説
OID 設定要求 OID_SWITCH_NIC_RESTORE を受信すると、拡張可能スイッチ拡張機能は、最初に実行時データを所有しているかどうかを判断する必要があります。 拡張機能は、自身を識別するために使用する GUID 値と、 ExtensionId メンバー NDIS_SWITCH_NIC_SAVE_STATE 構造体内 の値を比較することによって、これを行います。
拡張機能は、拡張可能スイッチ NIC のランタイムデータを所有している場合、次の方法でこのデータを復元します：
拡張機能は、 SaveData メンバーでのランタイムデータを拡張機能割り当てストレージにコピーします。
注PortId メンバー NDIS_SWITCH_NIC_SAVE_STATE 構造体の値は、ランタイムデータが保存された時点の PortId 値とは異なる場合があります。 これは、あるホストから別のホストへのライブ マイグレーション中にランタイムデータが保存された場合に発生する可能性があります。 ただし、拡張可能スイッチポートの構成は、ライブ マイグレーション中に保持されます。 これにより拡張機能は、新しい PortId 値を使用して、拡張可能スイッチ NIC にランタイムデータを復元できます。
拡張機能は、NDIS_STATUS_SUCCESS を使用して OID 設定要求を完了します。
拡張機能が指定したランタイム データを所有していない場合、拡張機能は NdisFOidRequest を呼び出して、この OID セット要求を拡張可能スイッチ ドライバー スタック内の下位拡張機能に転送します。 この場合、拡張機能は、OID 要求に関連付けられている NDIS_SWITCH_NIC_SAVE_STATE 構造体を変更することはできません。
OID_SWITCH_NIC_RESTORE 設定要求が拡張可能スイッチのミニポート エッジに受信された場合、NDIS_STATUS_SUCCESS を使って OID 要求が完了されます。 これにより、拡張スイッチのプロトコル エッジに、ランタイム データを所有する拡張機能のないことが通知されます。
ランタイム データを復元する方法の詳細については、 Hyper-V 拡張可能スイッチの実行時データの復元 を参照してください。
注 拡張機能が OID セット要求に失敗した場合、拡張可能スイッチは復元操作全体に失敗します。 その結果、可能であれば、拡張機能は OID 要求の失敗を回避する必要があります。 例えば、ランタイム データを復元するために必要なリソースを拡張機能が割り当てることができない場合に、ランタイム データを復元しなければ正常に機能できないならばOID 要求は失敗します。 ただし、拡張機能がエラー状態から回復できる場合は、OID セット要求を失敗させるべきではありません。
状態コードを返します
拡張機能は、OID_SWITCH_NIC_RESTORE の OID セット要求を完了すると、次のいずれかの状態コードを返します。
| 状態コード | 説明 |
|---|---|
NDIS_STATUS_SUCCESS |
OID 要求は正常に完了しました。 |
NDIS_STATUS_Xxx |
その他の理由で要求に失敗しました。 |
要件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |