NdisCoGetTapiCallId 함수(ndis.h)
NdisCoGetTapiCallId TAPI 애플리케이션이 특정 NDIS VC(가상 연결)를 식별하는 데 사용할 수 있는 문자열을 검색합니다.
통사론
NDIS_STATUS NdisCoGetTapiCallId(
[in] NDIS_HANDLE NdisVcHandle,
[in, out] PVAR_STRING TapiCallId
);
매개 변수
[in] NdisVcHandle
VC에 대한 NDIS 핸들을 지정합니다. 이 핸들은 NdisCoCreateVc 함수를 사용하여 VC를 처음 만들 때 NDIS에서 제공되었습니다.
[in, out] TapiCallId
VAR_STRING 형식의 데이터 구조를 수신하는 호출자 할당 버퍼에 대한 포인터입니다. 성공적으로 반환되면 이 구조는 TAPI 애플리케이션이 VC를 식별하는 데 사용할 수 있는 문자열을 설명합니다.
반환 값
다음 상태 값 중 하나를 반환합니다.
| 반환 코드 | 묘사 |
|---|---|
|
NDIS는 VC에 대한 문자열 식별자를 반환했습니다. |
|
VAR_STRING 구조체의 ulTotalSize 멤버는 버퍼의 크기가 VC를 식별하는 문자열을 보유할 만큼 크지 않음을 지정합니다. NdisCoGetTapiCallId VAR_STRING 구조체의 ulNeededSize 멤버를 필요한 크기(바이트)로 설정합니다. |
|
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) |