NetDeviceRequestReset 函式 (netadaptercx.h)

NetDeviceRequestReset 函式會觸發 NetAdapterCx 架構，以執行可復原無回應 NIC 裝置的平臺層級裝置重設作業。

語法

void NetDeviceRequestReset(
  [_In_] WDFDEVICE Device
);

[_In_] Device

無

用戶端驅動程式會在偵測到裝置失敗時呼叫 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