NdisCoGetTapiCallId 함수(ndis.h)

  • 아티클

NdisCoGetTapiCallId 는 TAPI 애플리케이션이 특정 NDIS VC(가상 연결)를 식별하는 데 사용할 수 있는 문자열을 검색합니다.

구문

NDIS_STATUS NdisCoGetTapiCallId(
  [in]      NDIS_HANDLE NdisVcHandle,
  [in, out] PVAR_STRING TapiCallId
);

매개 변수

[in] NdisVcHandle

VC에 대한 NDIS 핸들을 지정합니다. 이 핸들은 VC가 원래 NdisCoCreateVc 함수를 사용하여 만들어졌을 때 NDIS에서 제공되었습니다.

[in, out] 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에 대한 핸들이 잘못되었습니다.

설명

호출 관리자가 NdisCoCreateVc 를 호출하여 TAPI 호출에 대한 VC를 생성한다고 가정합니다. NDIS는 클라이언트에 VC에 핸들을 제공합니다. 클라이언트는 NdisCoGetTapiCallId 함수 호출에서 이 VC 핸들을 전달하여 VC를 식별하는 문자열을 검색합니다. 클라이언트는 이 문자열 식별자를 TAPI 애플리케이션에 전달하여 VC를 식별할 수 있습니다.

클라이언트는 관리하는 각 VC에 대한 컨텍스트를 만듭니다. 클라이언트는 NdisCoGetTapiCallId 를 사용하여 각 VC에 대한 문자열 식별자를 검색합니다. 클라이언트는 각 문자열 식별자를 TAPI 애플리케이션에 전달하여 각 VC를 식별합니다. 나중에 TAPI 애플리케이션이 VC 관련 작업에서 이러한 문자열 식별자 중 하나를 클라이언트에 전달하는 경우 클라이언트는 호출에서 이 문자열 식별자를 유니코드 문자열로 전달해야 합니다. NdisClGetProtocolVcContextFromTapiCallId 를 사용하여 VC에 대한 올바른 컨텍스트를 다시 가져옵니다.

VAR_STRING 구조에 대한 자세한 내용은 TAPI 개체를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista에서 NDIS 6.0 및 NDIS 5.1 드라이버(NdisCoGetTapiCallId(NDIS 5.1) 참조)에 대해 지원됩니다. Windows XP의 NDIS 5.1 드라이버(NdisCoGetTapiCallId(NDIS 5.1 참조))에 대해 지원됩니다.
대상 플랫폼 데스크톱
머리글 ndis.h(Ndis.h 포함)
라이브러리 Ndis.lib
IRQL DISPATCH_LEVEL
DDI 규정 준수 규칙 Irql_Connection_Function(ndis)

추가 정보

NdisClGetProtocolVcContextFromTapiCallId

NdisCoCreateVc