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
머리글	netadaptercx.h(netadaptercx.h 포함)
IRQL	PASSIVE_LEVEL

추가 정보

NetAdapterCx PLDR을 사용하여 응답하지 않는 NIC 복구

WdfDeviceCreate

NET_DEVICE_RESET_CAPABILITIES