TdiPnPPowerRequest

NTSTATUS
   TdiPnPPowerRequest(
       IN PUNICODE_STRING DeviceName,
       IN PNET_PNP_EVENT PowerEvent,
       IN PTDI_PNP_CONTEXT Context1,
       IN PTDI_PNP_CONTEXT Context2,
      IN ProviderPnPPowerComplete ProtocolCompletionHandler
       );

TdiPnPPowerRequest 함수는 NIC과 바인딩된 특정 트랜스포트 상에서 트랜스포트에서 모든 클라이언트로 전원상태 변화통보를 전달한다.

매개변수

DeviceName

트랜스포트와 NIC의 바인딩을 구현하는 트랜스포트 생성 장치 객체를 확인하는 버퍼화된 호출자 제공 유니코드 문자열을 가리킨다. 트랜스포트가 TdiRegisterDeviceObject 함수를 호출했을 때 이 이름을 사용하여 TDI를 가지고 전에 장치 객체를 등록했다.

PowerEvent

트랜스포트 스택에서 최하위 드라이버 혹은 트랜스포트의 ProtocolPnPEvent 함수에 대한 전원상태 이벤트를 인디케이트할 때 NDIS에 의해서 제공된 NET_PNP_EVENT 구조체를 가리킨다. 이 구조체의 NetEvent 멤버는 다음의 NDIS 정의 NET_PNP_EVENT_CODE 값중에 하나로 설정된다:

NetEventSetPower

NetEventQueryPower

NetEventQueryRemoveDevice

NetEventCancelRemoveDevice

Context1

이 타입의 전원상태 인디케이션과 연관된 트랜스포트 결정 컨텍스트를 가리킨다. 이 트랜스포트 제공 컨텍스트 정보는 원래 프로토콜 특정이다. 그리고 인디케이트를 어떻게 해석하고 다루는 지에 대한 힌트를 클라이언트에게 제공하는 경향이 있다.

예를들어 TCP/IP는 이 통보의 컨텍스트와 연관된 주소의 리스트로 포인터를 전달한다.

Context2

이 타입의 전원상태 인디케이션과 연관된 트랜스포트 결정 컨텍스트를 가리킨다.

예를들어 TCP/IP는 발생되는 이 통보를 위해서 물리 장치를 구현하는 PDO로 포인터를 전달한다.

ProtocolCompletionHandler

어떤 클라이언트가 이 통보를 비동기적으로 처리하고 나중에 이 인디케이션을 위해서 STATUS_SUCCESS가 아닌 다른 무엇인가를 리턴한다면 TDI가 호출하는 트랜스포트 제공 완료 루틴의 엔트리 포인트를 서술한다. 이 TDI 정의 핸들러는 다음과 같이 선언될 수 있다:


VOID

    MyPnPPowerCompletionCallback(

        IN PNET_PNP_EVENT  NetEvent,

        IN NTSTATUS  FinalStatus

        );

리턴값

모든 클라이언트가 이 통보를 동기적으로 처리하고 전원상태 변화의 승인을 인디케이트하기 위해서 STATUS_SUCCESS를 리턴한다면 TdiPnPPowerRequest 함수는 STATUS_SUCCESS를 리턴한다. 그렇지 않으면 다음중 하나를 리턴할 수 있다:

STATUS_PENDING: 적어도 하나의 클라이언트가 비동기적으로 이 통보를 처리할 것이다. 모든 클라이언트가 이 통보의 처리를 완료했을 때 TDI는 ProtocolCompletionHandler에서 트랜스포트 제공 루틴을 호출한다.
STATUS_INSUFFICIENT_RESOURCES: 현재 TDI는 전원상태 변화를 모든 클라이언트에게 알리기 위해서충분한 자원을 할당할 수 없다. 시스템 자원의 사용이 동적이기 때문에 같은 트랜스포트에서의 순차적인 호출은 성공할 수 있다.

주석

NDIS가 트랜스포트 스택 혹은 트랜스포트 드라이버의 lower edge에서 ProtocolPnPEvent 함수로의 호출을 가지고 트랜스포트에게 전원상태 변화 이벤트를 알릴 때 트랜스포트는 TdiPnPPowerRequest 함수로의 호출을 가지고 그들의 현재 네트웍 연산에 영향을 미치는 전원상태 변화를 상위 레벨 클라이언트에게 알릴 책임이 있다.

트랜스포트는 특히 NetEventReconfigure과 NetEventBindingList와 같은 NDIS 정의 타입처럼 어떤 PnP 타입의 이벤트를 가지고 이 호출을 하지 않는다는 것을 기억해라. 대신에 NDIS는 이 통보를 가지고 TDI를 호출하고 교대로 TDI는 모든 TDI 클라이언트의 등록된 ClientPnPBindingChange 함수를 호출한다. 각각의 클라이언트에 의해서 리턴된 상태에 의존하여 NDIS는 그러한 PnP 이벤트 통보에 의해서 영향을 받은 트랜스포트의 ProtocolBindAdapter나 ProtocolUnbindAdapter 함수를 호출한다.

그러한 트랜스포트는 TDI를 통해서 NDIS로부터 등록된 클라이언트까지 순차적인 통보로써 다른 TdiXxx 루틴을 호출한다. 예를들어 트랜스포트는 Connections 폴더안에 마지막 사용자에 의한 변화를 가지고 발생하는 NetEventBindingList 타입의 순차적인 통보로써 TdiRegisterDeviceObject와 TdiRegisterNetAddress 함수를 호출한다.

트랜스포트는 트랜스포트 스택의 lower edge에서 NDIS로부터 ProtocolBindAdapter 함수로 NetEventBindsComplete 타입의 순차적인 통보로써 시스템을 설정하는 동안에 TdiProviderReady 함수를 호출한다.

TdiPnPPowerRequest 함수의 호출자는 IRQL < DISPATCH_LEVEL에서 실행되어야한다.