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 を含む) |