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
대상 플랫폼	보편적
최소 UMDF 버전	2.33
헤더	netdevice.h(netadaptercx.h 포함)
IRQL	PASSIVE_LEVEL