EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE 콜백 함수(netdevice.h)

하드웨어와 호환되지 않는 절전 모드 해제 패턴을 거부하려면 이 선택적 콜백을 구현합니다.

구문

EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE EvtNetDevicePreviewWakeSource;

NTSTATUS EvtNetDevicePreviewWakeSource(
  [_In_] WDFDEVICE Device,
  [_In_] NETWAKESOURCE WakeSource
)
{...}

매개 변수

[_In_] Device

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

[_In_] WakeSource

검사할 절 해제 원본을 나타내는 NETWAKESOURCE 개체입니다.

반환 값

패턴을 수락하려면 콜백 함수가 STATUS_SUCCESS 반환해야 합니다.

패턴을 거부하려면 STATUS_NDIS_PM_WOL_PATTERN_LIST_FULL 반환합니다.

설명

NetAdapterCx는 드라이버의 NET_ADAPTER_WAKE_BITMAP_CAPABILITIES 호환되지 않는 절전 모드 해제 원본을 이미 차단하므로 드라이버는 EvtNetDevicePreviewWakeSource를 구현할 필요가 없습니다. 그러나 하드웨어에 비트맵 기능 구조로 표현할 수 없는 추가 제한 사항이 있는 경우 EvtNetDevicePreviewWakeSource 를 제공하여 이러한 추가 제한 사항을 적용할 수 있습니다.

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

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

이 콜백에서 클라이언트 드라이버는 절 해제 원본을 거부할 기회를 얻습니다. 예를 들어 디바이스 의 현재 절전 모드 해제 원본 목록에 있는 전원 필터 수가 하드웨어에서 지원하는 전원 필터 수에 이미 도달했거나 초과한 경우 드라이버는 이 절전 모드 해제 원본을 거부할 수 있습니다.

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10, 버전 2004
대상 플랫폼	유니버설
헤더	netdevice.h(netadaptercx.h 포함)
IRQL	PASSIVE_LEVEL