NetDeviceRequestReset 函式 (netadaptercx.h)
NetDeviceRequestReset 函式會觸發 NetAdapterCx 架構，以執行可復原無回應 NIC 裝置的平臺層級裝置重設作業。
語法
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 |