다음을 통해 공유

NdisIMNotifyPnPEvent 함수(ndis.h)

  • 아티클

참고 NDIS 5. x 더 이상 사용되지 않으며 NDIS 6으로 대체됩니다. x . 새로운 NDIS 드라이버 개발은 Windows Vista 시작하는네트워크 드라이버를 참조하세요. NDIS 5 포팅에 대한 자세한 내용입니다. x 드라이버를 NDIS 6에. x NDIS 5.x 드라이버를 NDIS 6.0 참조하세요.

NdisIMNotifyPnPEvent 플러그 앤 플레이 또는 전원 관리 이벤트의 알림을 지나치게 많은 드라이버에 전파합니다.

통사론

NDIS_STATUS NdisIMNotifyPnPEvent(
  [in] NDIS_HANDLE    MiniportHandle,
  [in] PNET_PNP_EVENT NetPnPEvent
);

매개 변수

[in] MiniportHandle

MiniportInitialize를핸들 입력입니다. 이 핸들은 호출자의 ProtocolPnPEvent 함수에 전달된 플러그 앤 플레이 또는 전원 관리 이벤트의 영향을 받는 미니포트 드라이버를 나타냅니다.

[in] NetPnPEvent

프로토콜 드라이버에 표시되는 플러그 앤 플레이 이벤트 또는 전원 관리 이벤트를 설명하는 NET_PNP_EVENT 구조체에 대한 포인터입니다.

반환 값

NdisIMNotifyPnPEvent 다음 중 하나를 반환할 수 있습니다.

반환 코드 묘사
NDIS_STATUS_SUCCESS 지나치게 많은 드라이버가 전파된 플러그 앤 플레이 이벤트가 성공했습니다.
NDIS_STATUS_FAILURE 지나치게 많은 드라이버가 전파된 플러그 앤 플레이 이벤트에 실패했습니다.

반환 값은 전파된 이벤트가 NetEventQueryPower 또는 NetEventQueryRemove경우에만 중요합니다. 전파된 다른 모든 이벤트의 경우 반환 값은 항상 NDIS_STATUS_SUCCESS.

발언

NDIS 중간 드라이버는 드라이버의 ProtocolPnPEvent 함수의 컨텍스트에서 NdisIMNotifyPnPEvent 호출하여 플러그 앤 플레이 또는 전원 관리 이벤트의 알림을 오버레이 드라이버로 전파합니다.

전파된 이벤트가 NetEventQueryPower 또는 NetEventQueryRemove 경우 중간 드라이버는 NdisIMNotifyPnPEvent반환된 NDIS_STATUS 값을 확인해야 합니다. 반환된 상태가 NDIS_STATUS_SUCCESS 경우 중간 드라이버는 평소와 같이 내부적으로 이벤트를 처리한 다음 ProtocolPnPEvent 함수에서 NDIS_STATUS_SUCCESS 반환해야 합니다. 반환된 상태가 NDIS_STATUS_FAILURE 경우 중간 드라이버는 추가 처리 없이 ProtocolPnPEvent NDIS_STATUS_FAILURE 반환해야 합니다.

전파된 다른 모든 이벤트의 경우 NdisIMNotifyPnPEvent 항상 NDIS_STATUS_SUCCESS 반환합니다. 이러한 경우 중간 드라이버의 ProtocolPnPEvent 함수는 NdisIMNotifyPnPEvent반환된 NDIS_STATUS 전파해야 합니다.

중간 드라이버가 ProtocolPnPEvent 함수에서 받은 NetEventSetPower 처리하는 방법은 지정된 디바이스 전원 상태에 따라 달라집니다. 지정된 디바이스 전원 상태가 NdisDeviceStateD0 경우 중간 드라이버는 평소와 같이 내부적으로 이벤트를 처리한 다음 NdisIMNotifyPnPEvent호출해야 합니다. 다른 지정된 디바이스 전원 상태의 경우 중간 드라이버는 먼저 NdisIMNotifyPnPEvent 호출한 다음, 평소와 같이 내부적으로 이벤트를 처리해야 합니다.

중간 드라이버는 NdisIMNotifyPnPEvent 호출하여 NetEventReconfigure 전파하거나 NetEventBindListNetEventReconfigure 또는 NetEventBindListNULLProtocolBindingContext표시됩니다. NetEventReconfigure 또는 NetEventBindListNULLProtocolBindingContext표시되는 경우 중간 드라이버는 이벤트를 전파하기 위해 NdisIMNotifyPnPEvent 호출하면 안 됩니다.

중간 드라이버가 NetEventReconfigure 또는 NetEventBindList처리하는 경우 이벤트와 연결된 데이터의 유효성을 검사해야 합니다. (이러한 데이터에 대한 자세한 내용은 프로토콜 드라이버대한NET_PNP_EVENT 참조하세요.)

NdisIMNotifyPnPEvent 대한 시스템 지원은 Windows XP 이상 버전에서 사용할 수 있습니다.

  • 대상 플랫폼: 유니버설
  • 버전: Windows Vista에서 NDIS 6.0 드라이버에 대해 지원되지 않습니다. 대신 NdisMNetPnPEvent사용합니다. Windows Vista 및 Windows XP에서 NDIS 5.1 드라이버에 대해 지원됩니다.

요구 사항

요구 값
헤더 ndis.h(Ndis.h 포함)
라이브러리 Ndis.lib
IRQL PASSIVE_LEVEL

참고 항목