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 |