EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD 콜백 함수(netdevice.h)

하드웨어와 호환되지 않는 프로토콜 오프로드를 거부하려면 이 선택적 콜백을 구현합니다.

구문

EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD EvtNetDevicePreviewPowerOffload;

NTSTATUS EvtNetDevicePreviewPowerOffload(
  [_In_] WDFDEVICE Device,
  [_In_] NETPOWEROFFLOAD PowerOffload
)
{...}

매개 변수

[_In_] Device

클라이언트 드라이버가 이전에 WdfDeviceCreate를 호출하여 가져온 WDFDEVICE 개체입니다.

[_In_] PowerOffload

검사할 저전력 프로토콜 오프로드를 나타내는 NETPOWEROFFLOAD 개체입니다.

반환 값

프로토콜 오프로드를 허용하려면 콜백 함수가 STATUS_SUCCESS 반환해야 합니다.

프로토콜 오프로드를 거부하려면 STATUS_NDIS_PM_PROTOCOL_OFFLOAD_LIST_FULL 반환합니다.

설명

NetAdapterCx는 이미 드라이버의 전원 오프로드 기능인 NET_ADAPTER_POWER_OFFLOAD_ARP_CAPABILITIES 및 NET_ADAPTER_POWER_OFFLOAD_NS_CAPABILITIES 호환되지 않는 프로토콜 오프로드를 차단하므로 드라이버는 EvtNetDevicePreviewPowerOffload를 구현할 필요가 없습니다. 그러나 하드웨어에 이러한 기능 구조에서 표현할 수 없는 추가 제한 사항이 있는 경우 EvtNetDevicePreviewPowerOffload 를 제공하여 이러한 추가 제한 사항을 적용할 수 있습니다.

NET_DEVICE_POWER_POLICY_EVENT_CALLBACKS 적절한 멤버를 설정한 다음 NetDeviceInitSetPowerPolicyEventCallbacks를 호출하여 이 콜백 함수의 구현을 등록합니다.

클라이언트 드라이버는 일반적으로 WdfDeviceCreate를 호출하기 전에 디바이스 개체를 만들 때 NetDeviceInitSetPowerPolicyEventCallbacks를 호출합니다.

이 콜백에서 클라이언트 드라이버는 프로토콜 오프로드를 거부할 수 있습니다. 예를 들어 디바이스 에 대한 현재 프로토콜 오프로드 목록의 프로토콜 오프로드 수가 하드웨어에서 지원하는 프로토콜 오프로드 수에 이미 도달했거나 초과한 경우 드라이버는 이 프로토콜 오프로드를 거부할 수 있습니다.

자세한 내용은 전원 관리 구성을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10, 버전 2004
최소 UMDF 버전	2.33
머리글	netdevice.h(netadaptercx.h 포함)
IRQL	PASSIVE_LEVEL