Chapter 4 TdiBuildXxx 매크로와 함수들

이것은 커널 모드 클라이언트가 IoCallDriver 함수를 가지고 하부의 TDI 트랜스포트 드라이버로 순차적으로 제시하는 TDI_XXX 내부 장치 통제 IRP를 설정하기 위해서 사용하는 시스템 제공 TdiBuildXxx 매크로를 서술한다.

이 매크로들의 매개변수는 ZwCreateFile 함수호출을 가지고 이미 열린 주소, 연결 엔드포인트, 통제 채널을 구현하는 파일 객체에 대한 포인터와 핸들을 항상 포함한다. ZwCreateFile 함수로의 성공적인 호출은 열린 파일 객체에 대한 핸들을 리턴한다. 클라이언트는 ObReferenceObjectByHandle 함수를 호출하므로써 그 파일 객체에 대한 포인터를 얻을 수 있다.

또한 이것은 커널 모드 클라이언트만이 호출하는 몇개의 TdiBuildXxx 함수들을 서술한다:

  • TdiBuildInternalDeviceControlIrp 함수는 TdiBuildXxx 매크로로 전달되고 그리고나서 커널 모드 클라이언트가 하부의 트랜스포트로 리퀘스트를 할 때 IoCallDriver 함수로 전달되는 IRP를 할당한다.

  • TdiBuildNetbiosAddressEa 함수는 NetBIOS 트랜스포트의 클라이언트가 NetBIOS 주소를 열기 위해서 순차적으로 ZwCreateFile 함수를 호출할 수 있는 주소를 서술하는 버퍼화된 EA를 설정한다.

  • TdiBuildNetbiosAddress 함수는 NetBIOS 트랜스포트의 클라이언트에 대해서 NetBIOS 주소를 설정한다.

트랜스포트 드라이버가 build-IRP 매크로에 의해서 설정된 TDI_XXX 리퀘스트를 어떻게 다루는지에 대한 더 많은 정보는 Chapter 2를 봐라. 여기에 언급된 IoCallDriver, ZwCreateFile, 그리고 ObReferenceObjectByHandle 함수같은 커널 모드 지원 루틴에 대한 더 많은 정보는 커널 모드 드라이버 디자인 가이드를 봐라.

ClientPnPXxx 핸들러와 그들이 PnP와 전원상태 변화통보를 어떻게 등록하는지에 대한 더 많은 정보는 각각 Chapter 5와 Chapter 3을 봐라.

여기에 서술된 매크로와 함수들은 알파벳 순서이다.