프로토콜 드라이버를 위한 NET_PNP_EVENT
typedef struct _NET_PNP_EVENT {
NET_PNP_EVENT_CODE NetEvent;
PVOID Buffer;
ULONG BufferLength;
UCHAR NdisReserved[16];
UCHAR TransportReserved[16];
UCHAR TdiReserved[16];
UCHAR TdiClientReserved[16];
} NET_PNP_EVENT, *PNET_PNP_EVENT;
|
NET_PNP_EVENT 구조체는 Power Management 이벤트 혹은 Plug and Play 이벤트를 설명한다.
멤버
- NetEvent
- 다음과 같은 하나로서 Plug and Play 혹은 Power Management 이벤트를 설명하는 이벤트 코드.
- NetEventSetPower
- 시스템 전원 상태로 전이하는 것을 지정하는 전원 관리자가 설정 전원 요구를 보내는 것을 가리킨다. NDIS는 이러한 상태를 장치를 위해 적당한 장치 전원 상태로 전환한다.
- NetEventQueryQueryPower
- 시스템 전원 상태로의 전이를 요구하는 전원 관리자가 쿼리 전원 요구를 보내는 것을 가리킨다. NDIS는 이러한 상태를 장치를 위해 적당한 장치 전원 상태로 전환한다.
- NetEventQueryRemoveDevice
- Plug and Play 관리자는 Query Remove Device 요구를 보내는 것을 가리킨다. Plug and Play 관리자는 이러한 요구를 장치가 연산들을 방해하는 것 없이 제거될 수 있는지를 쿼리하기 위해 보낸다.
- NetEventCancelRemoveDevice
- Plug and Play 관리자는 Cancel Remove Device 요구를 보내는 것을 가리킨다. PnP 관리자는 장치의 제거를 취소하기 위해 Query Remove Device 요구를 보낸 후 이러한 요구를 보낸다.
- NetEventReconfigure
- 구성이 네트워크 컴포넌트를 위해 변했다는 것을 가리킨다. 예를 들어 Network 과 Dial-up 연결들 폴더를 통해 사용자가 TCP/IP를 위한 IP 주소를 바꿨을 때, NDIS는 이 이벤트를 NetEventRecofigure 코드로 TCP/IP 프로토콜에 인디케이트한다.
- NetEventBindList
- 바인드 리스트가 바뀌었다는 것을 TDI 클라이언트에게 가리킨다. 바인드 리스트는 TDI 클라이언트가 그 자체와 바인드할 수 있는 전송 계층 프로토콜에 의해 익스포트된 하나 혹은 그 이상의 장치의 리스트이다.
- NetEventBindsComplete
- 프로토콜 드라이버가 바인드할 수 있는 모든 NIC들과 바인드를 했다는 것을 가리킨다. NDIS는 만약 Plug and Play NIC이 시스템에 플러그되어있지 않으면 프로토콜에게 어떤 NIC들을 인디케이트하지 않을 것이다.
- NetEventPnPCapabilites
- 지정된 바인딩에서 NIC의 wake-up 능력들이 바뀌었는지를 가리킨다. (바인딩은 ProtocolPnPEvent 함수로 전달된 ProtocolBindingContext에 의해 지정된다.)
- Buffer
- NetEvent에 의해 인디케이트된 Plug and Play 혹은 Power Management 이벤트 특정인 정보를 포함하는 버퍼의 주소를 지정한다.
- NetEventSetPower
- 버퍼는 장치가 전이하고 있는 장치 전원 상태를 포함한다.
NDIS가 프로토콜의 ProtocolPnPEvent 함수를 호출할 때, 장치 상태는 다음과 같은 값들 중 하나가 될 수 있는 NDIS_DEVICE_POWER_STATE이다.
- NdisDeviceStateUnspecified
- 네트워크 장치는 전원 관리를 지원하지 않는다.
- NdisDeviceStateD0
- 장치가 완전한 기능과 퍼포먼스를 전달하는 완전한 전원 상태.
- NdisDeviceStateD1
- 호스트로부터 전송 요구들은 장치에 의해 honor되지 않고, 장치에 의해 수신된 데이터는 호스트 메모리로 전송되지 않고 어떠한 인터럽트들도 발생할 수 없다. 몇몇 장치 컨텍스트는 잃어버릴 것이다. NIC과 미니포트의 능력들에 의존하여, 장치는 wake-up 시그널을 발생할 수 있을 것이다.
- NdisDeviceStateD2
- 항상 많은 전원 적은 컨텍스트가 저장되고 많은 시간이 완전한 전원 상태로의 전이로 필요되는 것을 제외한 NdisDeviceStateD1과 유사한 낮은 전원 상태.
- NdisDeviceStateD3
- 전원이 장치로부터 완전히 제거된 off 상태.
프로토콜이 관심이 있는 한, NdisDeviceStateD0는 NIC이 완전히 전원이 들어왔고 패킷들을 보내고 받을 수 있다는 것을 의미한다. 어떤 다른 장치 상태는 장치가 완전이 전원이 안들어왔고 패킷들을 보내고 받을 수 없다는 것을 의미한다.
- NdisEventQueryPower
- 버퍼는 장치에 의해 요구된 장치 전원 상태를 포함한다. 장치 상태는 NDIS_DEVICE_POWER_STATE이다.(위에 설명된)
- NdisEventQueryRemoveDevice
- 버퍼 내용들이 NULL이다.
- NdisEventCancelRemoveDevice
- 버퍼 내용들이 NULL이다.
- NdisEventReconfigure
- 버퍼 내용들이 NULL이다.
- NdisEventBindList
- 버퍼는 NET_PNP_EVENT 구조체가 전달되어지는 네트워크 컴포넌트를 위한 개정된 바인딩 리스트를 포함한다. 바인딩 리스트는 REG_MULTI_SZ 포맷을 가진다. 프로토콜과 바인드된 TDI 클라이언트들은 그들의 바인딩들을 재순서화하기 위해 이러한 바인딩 리스트를 사용한다.
- NetEventBindsComplete
- 버퍼 내용들이 NULL이다.
- NetEventPnPCapabilities
- 버퍼는 NdisDeviceWakeUpEnable 플래그를 포함하는 ULONG을 포함한다. 1로 설정될 때, 이러한 플래그는 특정 바인딩에서 NIC의 wake-up 능력들이 가능하다는 것을 가리킨다. (바인딩은 ProtocolPnPEvent 함수에 전달되어지는 ProtocolBindingContext에 의해 지정되어진다.) 0으로 설정될 때, 이러한 플래그는 NIC의 wake-up 능력들이 불가능하다는 것을 가리킨다.
- BufferLength
- Buffer에서 이벤트 특정 정보의 바이트 수
- NdisReserved
- NDIS에 의해 사용되어지는 예약된 공간
- TransportReserved
- 전송 계층 드라이버에 의해 사용되어지는 예약된 공간
- TdiReserved
- TDI에 의해 사용되어지는 예약된 공간
- TdiClientReserved
- TDI 클라이언트에 의해 사용되어지는 예약된 공간
주석
운영 체제가 NIC을 표시하는 타켓 장치 객체로 Plug and Play 이벤트 혹은 Power Management 이벤트를 발생할 때, NDIS는 이벤트를 가로채고, 그것을 NET_PNP_EVENT 구조체로 전환하고(translates) 이러한 구조체에 대한 포인터를 프로토콜의 ProtocolPnPEvent 함수를 호출함으로써 NIC에 바인드된 각 프로토콜에게 전달한다. 프로토콜은 드라이버가 포인터가 비동기적으로 ProtocolPnPEvent 함수에 대한 호출을 완성하기 위해 드라이버가 호출하는 NdisCompletePnPEvent 함수에 입력 매개변수이기 때문에, 이러한 포인터를 저장한다.
NDIS는 또한 NetEventBindsComplete 이벤트를 그러한 드라이버에게 알리기 위해 특정 프로토콜 드라이버의 ProtocolPnPEvent 함수를 호출할 수 있다. 이러한 이벤트는 프로토콜 드라이버에게 시스템에서 바인드할 수 있는 모든 NIC들에 바인드되어지는 프로토콜 드라이버에게 가리킨다.
구조체에서 NetEvent 코드는 Plug and Play 혹은 Power Management 이벤트의 타입을 지정한다. Buffer는 이벤트 타입 특정인 정보를 포함한다.
전송 계층들은 일반적으로 Plug and Play 이벤트 혹은 Power Management 이벤트에 대한 상태를 유지하기 위해 TransportReserved 영역을 사용한다.
|