次の方法で共有

NetDeviceRequestReset 関数 (netadaptercx.h)

  • [アーティクル]

NetDeviceRequestReset 関数は、応答しない NIC デバイスを回復するプラットフォーム レベルのデバイス リセット操作を実行するために NetAdapterCx フレームワークをトリガーします。

構文

void NetDeviceRequestReset(
  [_In_] WDFDEVICE Device
);

パラメーター

[_In_] Device

WdfDeviceCreateへの呼び出しで以前に作成したクライアント ドライバーWDFDEVICE オブジェクト。

戻り値

何一つ

備考

クライアント ドライバーは、デバイスの障害 検出したときに NetDeviceRequestReset を呼び出します。 NetDeviceRequestReset はすぐにクライアント ドライバーに返されます。 ドライバーは、PASSIVE_LEVEL NetDeviceRequestReset のみを呼び出すことができます。

NetDeviceRequestReset は非ブロッキングであり、クライアント ドライバーに直ちに返されます。 クライアント ドライバーは、現在失敗しているデバイスにアクセスする進行中のジョブをすべて取り消す必要があります。

クライアント ドライバーでは、デバイスのリセットと回復プロセス中に意味のあるリセット診断を収集する NET_DEVICE_RESET_CAPABILITIES 構造を設定することをお勧めします。 リセット診断を収集する方法の詳細については、「オプションの診断コレクション コールバックを登録する」を参照してください。

NetDeviceRequestReset は、PCIe ベースの NIC デバイスにのみ適用されます。 USB ベースの NIC デバイスの場合は、「USB パイプ エラーから回復する方法」で説明されているプロセスに従います。

デバイスで回復不能なハードウェアまたはソフトウェア エラーが発生した場合、クライアント ドライバーは WdfDeviceSetFailed 関数を使用できます。

必要条件

要件 価値
サポートされる最小クライアント Windows 11
サポートされる最小サーバー Windows Server 2022
UMDF の最小バージョン を する 2.33
ヘッダー netadaptercx.h (netadaptercx.h を含む)
IRQL PASSIVE_LEVEL

関連項目

NetAdapterCx PLDR を使用して応答しない NIC を回復する

WdfDeviceCreate

NET_DEVICE_RESET_CAPABILITIES