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 |
| Header | netadaptercx.h (netadaptercx.h を含む) |
| IRQL | PASSIVE_LEVEL |