TdiRegisterDeviceObject

NTSTATUS
   TdiRegisterDeviceObject(
       IN PUNICODE_STRING DeviceName,
       OUT HANDLE *DevRegistrationHandle
       );

TdiRegisterDeviceObject 함수는 트랜스포트가 특정 트랜스포트와 NIC과의 바인딩 상에서 클라이언트의 네트웍 I/O 리퀘스트의 타겟을 구현하는 새로운 장치 객체를 생성했음을 트랜스포트의 클라이언트에게 알린다.

매개변수

DeviceName

트랜스포트 생성 장치 객체를 확인하는 유니코드 문자열을 포함하는 호출자 할당 버퍼를 가리킨다.

DevRegistrationHandle

이 호출이 성공한다면 불투명한 핸들을 리턴하는 TdiRegisterDeviceObject 함수의 호출자 제공 로케이션의 변수를 서술한다.

리턴값

TdiRegisterDeviceObject 함수는 모든 트랜스포트의 클라이언트 등록을 알 때 STATUS_SUCCESS를 리턴한다. 그렇지 않으면 STATUS_INSUFFICIENT_RESOURCES를 리턴한다. (시스템 자원의 사용이 동적이기 때문에 같은 트랜스포트로의 순차적인 호출은 성공할 수 있다.)

주석

트랜스포트 스택이 하부의 NDIS 미니포트 드라이버와 바인딩된 후에 TDI 트랜스포트는 새롭게 성립된 트랜스포트와 NIC과의 바인딩상에서 클라이언트의 네트웍 I/O 리퀘스트에 대해서 타겟을 구현하기 위해 IoCreateDevice 함수를 가지고 명명된 장치 객체를 생성해야한다. 그리고나서 트랜스포트는 TdiRegisterDeviceObject 함수를 호출해야한다. 이것은 TDI로 하여금 주어진 DeviceName 포인터와 입력 값이 TDI_PNP_OPCODE_ADD인 PnPOpcode를 가지고 트랜스포트 클라이언트의 모든 등록된 ClientPnPBindingChange 루틴을 호출하도록한다.

TdiRegisterDeviceObject 함수의 성공적인 호출자는 트랜스포트가 바인딩을 끊었을 때 TdiDeregisterDeviceObject 함수로의 순차적이고 상호적인 호출을 위해서 *DevRegistrationHandle에 리턴되는 값을 저장한다. 또한 트랜스포트는 TdiRegisterNetAddress와 TdiPnPPowerRequest 함수로의 순차적인 호출을 위해서 DeviceObject에 버퍼화된 문자열을 저장해야한다.

IoCreateDevice 함수호출의 특징에 대해서는 커널 모드 드라이버 레퍼런스를 봐라.

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