TSPI_lineSetMediaMode 함수(tspi.h)
TSPI_lineSetMediaMode 함수는 호출의 LINECALLINFO 구조에 저장된 대로 호출의 미디어를 변경합니다.
구문
LONG TSPIAPI TSPI_lineSetMediaMode(
HDRVCALL hdCall,
DWORD dwMediaMode
);
매개 변수
hdCall
미디어 유형이 변경되는 호출에 대한 핸들입니다. hdCall의 호출 상태는 모든 상태일 수 있습니다.
dwMediaMode
호출에 대한 새 미디어 유형입니다. LINEMEDIAMODE_UNKNOWN 미디어 형식 플래그가 설정된 한 다른 여러 미디어 형식 플래그도 설정할 수 있습니다. 이는 통화의 미디어 유형을 완전히 결정되지는 않았지만 지정된 미디어 형식의 작은 집합 중 하나로 좁혀지는 것으로 식별하는 데 사용됩니다. LINEMEDIAMODE_UNKNOWN 플래그를 설정하지 않으면 단일 미디어 유형만 지정할 수 있습니다. 이 매개 변수는 LINEMEDIAMODE_ 상수 중 하나 이상을 사용합니다.
반환 값
함수가 성공하면 0을 반환하고 오류가 발생하면 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALMEDIAMODE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
설명
호출의 LINECALLINFO 구조에 저장된 대로 통화의 미디어를 변경하는 것 외에, 이 절차는 호출에 대한 특정 변경을 강제하는 대신 예상되는 미디어 변경이 발생한다는 점에서 권고일 뿐입니다. 일반적인 사용법은 통화의 미디어 형식을 알려진 특정 미디어 유형으로 설정하거나 통화의 미디어 유형을 완전히 알 수 없는 한 가능한 미디어 유형을 제외하는 것입니다(UNKNOWN 미디어 형식 플래그가 설정됨).
TAPI는 전달된 미디어 유형에 대해 다음과 같은 보장을 수행합니다. (1) 하나 이상의 비트 집합이 있고, (2) 예약된 비트 집합이 없으며, (3) 둘 이상의 비트가 설정된 경우 "알 수 없음"도 설정됩니다. 서비스 공급자는 미디어 유형이 실제로 서비스 공급자에서 지원되는지 여부를 확인하는 등 미디어 유형에 대한 추가 유효성 검사를 수행해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | tspi.h |