NdisMIdleNotificationConfirm 함수(ndis.h)

  • 아티클

미니포트 드라이버는 NdisMIdleNotificationConfirm 을 호출하여 유휴 네트워크 어댑터를 안전하게 일시 중단하고 저전력 상태로 전환할 수 있음을 NDIS에 알립니다.

미니포트 드라이버는 NDIS 선택적 일시 중단 작업 중에 이 함수를 호출합니다. NDIS는 드라이버의 MiniportIdleNotification 처리기 함수를 호출할 때 작업을 시작합니다.

구문

void NdisMIdleNotificationConfirm(
  [in] NDIS_HANDLE             MiniportAdapterHandle,
  [in] NDIS_DEVICE_POWER_STATE IdlePowerState
);

매개 변수

[in] MiniportAdapterHandle

NDIS가 MiniportInitializeEx의 MiniportAdapterHandle 매개 변수에 전달한 네트워크 어댑터 핸들입니다.

[in] IdlePowerState

네트워크 어댑터가 저전력 상태 전환에 대해 지원하는 가장 낮은 전원 상태를 지정하는 NDIS_DEVICE_POWER_STATE 열거형 값입니다.

참고 USB 네트워크 어댑터의 경우 이 매개 변수는 NdisDeviceStateD2여야 합니다.
 

반환 값

없음

설명

미니포트 드라이버는 NDIS가 드라이버의 MiniportIdleNotification 함수를 호출한 후 NdisMIdleNotificationConfirm을 호출합니다. NdisMIdleNotificationConfirm을 호출하면 드라이버는 일시 중단 작업을 시작할 수 있고 네트워크 어댑터를 저전력 상태로 전환할 수 있음을 NDIS에 알릴 수 있습니다. 이 호출에서 미니포트 드라이버는 IdlePowerState 매개 변수를 디바이스가 전환할 수 있는 가장 낮은 전원 상태로 설정합니다.

미니포트 드라이버가 NdisMIdleNotificationConfirm을 호출하기 전에 네트워크 어댑터를 선택적으로 일시 중단하는 데 필요할 수 있는 버스별 I/O 요청 패킷(IRP)을 실행해야 합니다.

예를 들어 NDIS가 MiniportIdleNotification 함수를 호출하는 경우 USB 미니포트 드라이버는 USB 버스 드라이버에 USB 유휴 요청(IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION)에 대한 버스별 IRP(I/O 요청 패킷)를 발급합니다. USB 버스 드라이버가 네트워크 어댑터가 저전력 상태로 전환될 수 있음을 확인하면 IRP와 연결된 콜백 루틴을 호출합니다. 콜백 루틴의 컨텍스트 내에서 USB 미니포트 드라이버는 NdisMIdleNotificationConfirm을 호출합니다. 자세한 내용은 USB 유휴 요청 IRP 콜백 루틴 구현을 참조하세요.

참고 미니포트 드라이버는 이전에 완료된 유휴 알림에 대해 NdisMIdleNotificationConfirm 을 호출해서는 안 됩니다. 미니포트 드라이버는 NdisMIdleNotificationComplete를 호출하여 유휴 알림을 완료합니다.
 
NDIS 선택적 일시 중단 유휴 알림을 처리하는 방법에 대한 자세한 내용은 NDIS 선택적 일시 중단 유휴 알림 처리를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 NDIS 6.30 이상에서 지원됩니다.
대상 플랫폼 유니버설
헤더 ndis.h(Ndis.h 포함)
라이브러리 Ndis.lib
IRQL PASSIVE_LEVEL

추가 정보

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete