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 |
참고 항목
NetAdapterCx PLDR 사용하여 응답하지 않는 NIC 복구