ProtocolPnPEvent
NDIS_STATUS
ProtocolPnPEvent(
IN NDIS_HANDLE ProtocolBindingContext,
IN PNET_PNP_EVENT NetPnPEvent
);
|
ProtocolPnPEvent 함수는 Plug and Play와 Power Management를 지원하는 프로토콜 드라이버에서 필요한 함수이다. NDIS는 NIC과 바인드된 프로토콜에 대해 Plug and Play 이벤트 혹은 Power Management 이벤트를 가리키기 위해 ProtocolPnPEvent 함수를 호출한다.
매개변수
- ProtocolBindingContext
- 이러한 드라이버가 바인딩 당 런타임 상태를 유지하는 프로토콜 할당 컨텍스트 영역에 대한 핸들을 지정한다. 프로토콜은 NdisOpenAdapter 함수를 호출할 때 이 핸들을 제공한다. NULL ProtocolBindingContext로 인디케이트된 NetEventXxx는 모든 네트워크 바인딩들에 속한다. NetEventBindList 와 NetEventBindsComplete는 항상 NULL ProtocolBindingContext로 인디케이트된다. NetEventReconfigure는 특정 ProtocolBindingContext로 인디케이트될 수 있거나 혹은 NULL ProtocolBindingContext이다.
- NetPnPEvent
- 프로토콜 드라이버에 인디케이트되는 Plug and Play 이벤트 혹은 Power Management 이벤트를 설명하는 NET_PNP_EVENT 구조체를 가리킨다.
리턴값
ProtocolPnPEvent 함수는 다음과 같은 어떤 값을 리턴할 수 있다:
- NDIS_STATUS_SUCCESS
- 프로토콜은 성공적으로 인디케이트된 Plug and Play 혹은 Power Management 이벤트를 다룬다. 이러한 상태 코드의 의미는 NetPnPEvent에 버퍼화된 NET_PNP_EVENT 구조체내에 NetEvent 코드에 의존한다.
- NetEventSetPower
- 장치는 요구된 파워 장치 파워 상태로 전이했다.
- NetEventQueryPower
- 장치는 요구된 장치 파워 사태로 전이할 수 있다.
- NetEventQueryRemoveDevice
- 장치는 제거될 수 있다.
- NetEventCancelRemoveDevice
- 장치의 제거는 취소되어졌다.
- NetEventReconfigure
- 프로토콜이 변화된 구성 매개변수들을 수락했다.
- NetEventBindList
- 프로토콜이 프로토콜로 ClientBinding 핸들러를 등록했던 모든 바인드된 TDI 클라이언트들에 대한 새로운 바인딩 리스트를 convey했다.
- NetEventBindsComplete
- 프로토콜은 프로토콜이 모든 이용할 수 있는 NIC들에 바인드했던 것으로부터 인디케이션을 인식했다.
- NetEventPnPCapabilities
- 프로토콜은 특정 바인딩에 대해 NIC의 wake-up 능력들이 변화되었다고 인식했다.
- NDIS_STATUS_PENDING
- 프로토콜은 NdisCompletePnPEvent 함수에 대한 호출로 비동기적으로 인디케이트된 이벤트에 대한 응답을 리턴할 것이다.
- NDIS_STATUS_RESOURCES
- 프로토콜은 인디케이트된 Plug and Play 혹은 Power Management 이벤트를 만족하기 위해 필요한 시스템 자원들을 얻을 수 없다.
- NDIS_STATUS_NOT_SUPPORTED
- 리거시(비 PnP 인식인) 프로토콜은 NDIS가 NIC으로부터 그것을 바인드를 해제해야 하는 것을 가리키기 위해 NetEventSetPower에 응답하여 이러한 상태를 리턴할 수 있다.
- NDIS_STATUS_FAILURE
- 프로토콜은 인디케이트된 Plug and Play 혹은 Power Management 이벤트가 실패한다. 이 상태 코드의 의미는 NetPnPEvent인 버퍼화된 NET_PNP_EVENT 구조체내에 NetEvent 코드에 달려 있다.
- NetEventSetPower
- 프로토콜은 이 이벤트를 실패할 필요가 없다.
- NetEventQueryPower
- 프로토콜은 이 이벤트를 실패할 필요가 없다.
- NetEventQueryRemoveDevice
- 프로토콜은 장치를 해제할 수 없다.
- NetEventCancelRemoveDevice
- 프로토콜은 이 이벤트를 실패할 필요가 없다.
- NetEventReconfigure
- 프로토콜은 이 이벤트를 실패할 필요가 없다.
- NetEventBindList
- 프로토콜은 이 이벤트를 실패할 필요가 없다.
- NetEventBindsComplete
- 프로토콜은 이 이벤트를 실패할 필요가 없다.
- NetEventPnPCapabilities
- 프로토콜은 이 이벤트를 실패할 필요가 없다.
주석
NDIS는 운영체제가 NIC을 나타내는 장치 객체에 Plug and Play 혹은 Power Management 이벤틀 발생하는 네트워크 NIC에 바운드된 프로토콜을 알리기 위해 ProtocolPnPEvent 함수를 호출한다. NDIS는 NIC과 바인드된 각 프로토콜의 ProtocolPnPEvent 함수를 호출한다.
ProtocolPnPEvent 함수에 전달되는 NET_PNP_EVENT 구조체는 Plug and Play 혹은 Power Management 이벤트를 설명한다. ProtocolPnPEvent 함수는 NET_PNP_EVENT 구조체내에 두개의 기본 정보를 해석한다.
- Plug and Play 혹은 Power Management 이벤트를 설명하는 NetEvent 코드
- 이벤트 특정 정보(예를 들어, NetEventSetPower인 장치가 전이되고 있는 장치 전원 상태)
프로토콜은 NetPnPEvent 포인터를 저장해야 한다. 이러한 포인터는 프로토콜이 만약 ProtocolPnPEvent 함수가 NDIS_STATUS_PENDING를 리턴한다면 연속해서 호출해야 하는 NdisCompletePnPEvent 함수에 대한 필요한 입력 매개변수이다.
프로토콜은 항상 NetEventQueuryPower가 이어진다(succeed). 활동인 연결을 설립한 후, 프로토콜은 계속적으로 바쁜 상태를 등록하기 위해 PoRegisterSystemState 함수를 호출할 수 있다. 상태 등록이 효과적인 동안, Power Management는 시스템이 sleep로 놓도록 시도하지 않는다. 연결이 비활성화된 후, 프로토콜은 PoUnregisterSystemState 함수를 호출함으로써 상태 등록을 취소한다. 프로토콜은 결코 NetEventQueryRemoveDevice를 실패함으로써 sleeping 상태로 시스템이 전이되는 것을 막을 시도를 하지 않는다. NetEventQueryPower은 항상 NetEventSetPower가 따른다는 것을 주목하라. 효율적으로 장치의 현 전원 상태로 NetEventSetPower은 NetEventQeuryPower를 취소한다.
만약 프로토콜이 장치를 해제할 수 없다면(예를 들어, 장치가 사용중이라면), NDIS_STATUS_FAILURE를 리턴함으로써 NetEventQueryRemoveDevice를 실패해야 한다.
프로토콜은 항상 NDIS_STATUS_SUCCESS를 리턴함으로써 NetEventCancelRemoveDevice, NetEventReconfigure, NetEventBindList, NetEventBindsComplete, NetEventSetPower가 이어진다.(succeed)
PnP 인식 프로토콜은 항상 NetEventSetPower가 이어져야 한다. 전원 관리를 지원하지 않는 리거시 프로토콜은 NDIS가 NIC으로부터 프로토콜을 언바인드해야 하는 것을 가리키기 위해 NetEventSetPower에 응답하여 NDIS_STATUS_NOT_SUPPORTED를 리턴한다.
프로토콜은 Plug and Play 혹은 Power Management 이벤트를 위해 NDIS_STATUS_RESOURCES를 리턴할 수 있다.
|