NdisClGetProtocolVcContextFromTapiCallId

NDIS_STATUS NdisClGetProtocolVcContextFromTapiCallId( IN UNICODE_STRING TapiCallId, OUT PNDIS_HANDLE ProtocolVcContext );

NdisClGetProtocolVcContextFromTapiCallId함수는 TAPI 호출 ID스트링에의해 확인되는 가상 연결(VC)에대한 클라이언트 컨택스트를 생성한다.

매개변수

TapiCallId

특별한 VC를 확인하는 유니코드 스트링. 이 스트링은 NdisCoGetTapiCallID함수에의해 이전에 리턴된 스트링 확인자의 유니코드 버전이다.

ProtocolVcContext

VC에대한 클라이언트의 컨택스트의 핸들을 받은 호출자 할당 NDIS_HANDLE의 포인터. 클라이언트는 이 컨택스트를 ProtocolCoCreateVc핸들러로부터 리턴에서 NDIS에게 이컨택스트를 제공한다.

리턴값

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

NDIS_STATUS_SUCCESS

NDIS는 성공적으로 TAPI 호출 ID스트링에의해 확인되는 VC에대한 클라이언트 VC컨택스트에대한 핸들을 생성한다.

NDIS_STATUS_FAILURE

클라이언트 VC컨텍스트에대한 핸들을 생성하기위한 시도는 실패이다.

주석

콜 매니저가 TAPI호출에대한 VC를 생성하기위해 NdisCoCreateVc를 호출한다고 가정하라.NDIS 차례로 VC에대한 핸들을 클라이언트에게 제공한다. 클라이언트는 이 VC핸들을 VC에대한 스트링 확인자를 생성하기위해 NdisCoGetTapiCallId함수의 호출에 VC핸들을 넘긴다. 클라이언트는 그리고나서 이 확인자를 VC에대한 컨택스트를 다시 얻기위해 NdisClGetProtocolVcContextFromTapiCallId함수에게 유니코드 스트링으로써 표현한다.

클라이언트는 클라이언트가 다루는 각 VC에대한 컨텍스트를 생성한다. 클라이언트는 각 VC에대한 스트링 확인자를 생성하기위해 NdisCoGetTapiCallID를 사용한다. 클라이언트는 각 스트링 확인자를 각 VC를 확인하기위해 TAPI어플리케이션에게 넘긴다. 나중에, 만약 TAPI어플리케이션이 이 스트링 확인자들중 하나를 VC관련 연산의 클라이언트에게 내려보내면, 클라이언트는 이 스트링 확인자를 VC에대한 올바른 컨택스트에게 다시 돌겨주기위한 NdisClGetProtocolVcContextFromTapiCallId의 호출내의 유니코드 스트링으로써 넘겨야한다.

UNICODE_STRING구조체의 정의에대해서는, Microsoft Windows 2000 DDK내의 Kernel-Mode Drivers Reference를 보라.

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