次の方法で共有

OID_SWITCH_NIC_SAVE_COMPLETE

  • [アーティクル]

Hyper-V 拡張可能スイッチのプロトコル エッジは、実行時データを保存する操作の完了について Hyper-V 拡張可能スイッチ拡張機能に通知するOID_SWITCH_NIC_SAVE_COMPLETE のオブジェクト識別子 (OID) セット要求を発行します。 この操作により、拡張機能は、ポートとそれに関連付けられているネットワーク アダプター接続のランタイム データを保存します。

NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、 NDIS_SWITCH_NIC_SAVE_STATE 構造体を指すポインターが含まれています。

解説

OID 設定要求 OID_SWITCH_NIC_SAVE_COMPLETE を受信すると、拡張機能は次のガイドラインに従う必要があります：

  • 拡張機能は、OID 要求に関連付けられている NDIS_SWITCH_NIC_SAVE_STATE 構造体を変更することはできません。

  • 拡張機能は、 NdisFOidRequest を呼び出して、この OID セット要求を拡張可能スイッチ ドライバー スタック内の基になる拡張機能に転送する必要があります。 拡張機能は OID 要求を失敗してはなりません。

OID_SWITCH_NIC_SAVE_COMPLETE の OID メソッド要求は、最終的には拡張可能スイッチの下位ミニポート エッジによって処理されます。 この OID メソッド要求は、ミニポート エッジによって受信された後、NDIS_STATUS_SUCCESS を使用して OID 要求を完了します。 これにより、拡張可能スイッチ ドライバー スタック内のすべての拡張機能が保存操作を完了したことを、拡張可能スイッチのプロトコル エッジに通知します。

拡張可能スイッチ ポートの実行時データを保存する方法の詳細については、 Hyper-V 拡張可能スイッチの実行時データの保存 を参照してください。

状態コードを返します

拡張可能スイッチの下位ミニポート エッジは、OID_SWITCH_NIC_SAVE_COMPLETE の OID クエリ要求を完了し、次のいずれかの状態コードを返します。

状態コード 説明

NDIS_STATUS_SUCCESS

OID 要求は正常に完了しました。

要件

バージョン

NDIS 6.30 以降でサポートされています。

ヘッダー

 Ntddndis.h (Ndis.h を含む)

関連項目

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_SAVE_STATE