NdisCoGetTapiCallId

NDIS_STATUS NdisCoGetTapiCallId( IN NDIS_HANDLE NdisVcHandle, IN OUT PVAR_STRING TapiCallId );

NdisCoGetTapiCallId함수는 TAPI어플리케이션들이 지정한 NDIS가상 연결(VC)를 확인하기위해 사용할수 있는 스트링을 생성한다.

매개변수

NdisVcHandle

VC에대한 NDIS핸들을 지정한다. 이 핸들은 VC가 NdisCoCreateVc 함수로 처음에 생성됐을때, NDIS의해 제공된다.

TapiCallId

VAR_STRING타입의 데이타 구조체를 받는 호출자 할당 버퍼의 포인터. 성공적으로 리턴하자마자, 이 구조체를 TAPI어플리케이션이 VC를 확인하기위해 사용할수 있는 스트링을 묘사한다.

리턴값

다음중 하나의 상태 값을 리턴한다.:

NDIS_STATUS_SUCCESS

NDIS는 VC대한 스트링 확인자를 성공적으로 리턴한다.

NDIS_STATUS_BUFFER_TOO_SHORT

VAR_STRING 구조체의 ulTotalSize멤버는 버퍼의 사이즈가 VC를 확인하는 스트링을 넣기에 충분하지가 않다는것을 지정한다. NdisCoGetTapiCallId함수 VAR_STRING구조체의 ulNeededSize멤버를 요구되는 바이트 사이즈로 설정한다.

NDIS_STATUS_INVALID_DATA

NdisVcHandle에의해 지정된 VC에대한 핸들이 무효하다.

주석

콜 매니저가 TAPI호출에대한 VC를 생성하기위해 NdisCoCreateVc 함수를 호출한다고 가정하자. 다음으로 NDIS는 클라이언트에게 그VC에대한 핸들을 제공한다. 클라이언트는 호출내의 이 VC핸들을 VC를 확인하는 스트링을 생성하기위해 NdisCoGetTapiCallId 함수에게 넘긴다.

클라이언는 클라이언트가 다루는 각 VC에대한 컨텍스트를 생성한다. 클라이언트는 각 VC에대한 스트링 확인자를 생성하기위해 NdisCoGetTapiCallID 함수를 사용한다. 클라이언트는 각 스트링 확인자를 각 VC를 확인하기위해 TAPI어플리케이션에게 넘긴다. 나중에, 만약 TAPI어플리케이션이 이 스트링 확인자들중 하나를 VC와 관계된 연산에서의 클라이언트에게 넘긴다면, 클라이언트는 이 유니코드 스트링으로써의 스트링 확인자를 VC에대한 올바른 컨텍스트를 다시 얻기위해 VC와 관계된 NdisClGetProtocolVcContextFromTapiCallI함수에서의 클라이언트에게 넘긴다.

VAR_STRING 구조체에대한 더많은 정보는 TAPI Objects를 봐라.

NdisCoGetTapiCallId함수의 호출자는 IRQL DISPATCH_LEVEL에서 동작되어야만 한다.