MINIPORT_WDI_IDLE_NOTIFICATION 콜백 함수(dot11wdi.h)

중요

이 항목은 Windows 10 릴리스된 WDI 드라이버 모델의 일부입니다. WDI 드라이버 모델은 유지 관리 모드이며 높은 우선 순위 수정만 받습니다. WiFiCx는 Windows 11 릴리스된 Wi-Fi 드라이버 모델입니다. WiFiCx를 사용하여 최신 기능을 활용하는 것이 좋습니다.

NDIS는 MiniportWdiIdleNotification 처리기 함수를 호출하여 유휴 네트워크 어댑터에서 NDIS 선택적 일시 중단 작업을 시작합니다. 이 작업을 통해 네트워크 어댑터가 일시 중단되고 저전력 상태로 전환됩니다.

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS 내의 WDI 미니포트 처리기입니다.

참고

MINIPORT_WDI_IDLE_NOTIFICATION 형식을 사용하여 함수를 선언해야 합니다. 자세한 내용은 다음 예제 섹션을 참조하세요.

구문

MINIPORT_WDI_IDLE_NOTIFICATION MiniportWdiIdleNotification;

NDIS_STATUS MiniportWdiIdleNotification(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] BOOLEAN ForceIdle
)
{...}

매개 변수

[in] MiniportAdapterContext

미니포트 드라이버가 할당한 컨텍스트 영역에 대한 핸들입니다.

[in] ForceIdle

TRUE로 설정하면 미니포트 드라이버가 유휴 알림을 거부해서는 안 되며 저전력 상태 전환을 계속해야 한다고 지정하는 BOOLEAN 값입니다.

ForceIdle 매개 변수에 대한 자세한 내용은 설명 섹션을 참조하세요.

반환 값

MiniportWdiIdleNotification은 다음 반환 값 중 어느 것을 반환할 수 있습니다.

반환 코드	설명
NDIS_STATUS_PENDING	미니포트 드라이버가 유휴 알림을 성공적으로 처리했습니다. 미니포트 드라이버가 NdisWdiIdleNotificationComplete를 호출할 때까지 알림은 보류 중인 상태로 유지됩니다. 참고: 미니포트 드라이버는 MiniportWdiIdleNotification에서 NDIS_STATUS_SUCCESS 반환해서는 안됩니다.
NDIS_STATUS_BUSY	네트워크 어댑터가 여전히 사용 중이므로 미니포트 드라이버가 유휴 알림을 거부했습니다. 참고:ForceIdle 매개 변수가 TRUE로 설정된 경우 MiniportWdiIdleNotification은 이 상태 코드를 반환해서는 안 됩니다.
NDIS_STATUS_FAILURE	미니포트 드라이버가 버스별 IRP를 성공적으로 발급할 수 없습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10
지원되는 최소 서버	Windows Server 2016
대상 플랫폼	Windows
헤더	dot11wdi.h

추가 정보

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

NdisWdiIdleNotificationComplete