TSPI_lineSelectExtVersion 함수(tspi.h)
TSPI_lineSelectExtVersion 함수는 표시된 줄 디바이스에 대해 표시된 확장 버전을 선택합니다. 후속 요청은 해당 확장 버전에 따라 작동합니다.
구문
LONG TSPIAPI TSPI_lineSelectExtVersion(
HDRVLINE hdLine,
DWORD dwExtVersion
);
매개 변수
hdLine
확장 버전을 선택할 줄에 대한 핸들입니다.
dwExtVersion
선택할 확장 버전입니다. 이 버전 번호는 TSPI_lineNegotiateExtVersion 사용하여 협상되었습니다. 가장 중요한 WORD 는 주 버전 번호이고 가장 중요한 WORD 는 부 버전 번호입니다. dwExtVersion이 0인 이 함수를 호출하면 현재 선택 영역이 취소됩니다.
반환 값
함수가 성공하면 0을 반환하고 오류가 발생하면 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.
LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
설명
서비스 공급자가 표시된 확장 버전을 선택합니다. 표시된 버전 번호가 성공적으로 협상되었을 수 있지만 중간에 다른 확장 버전이 선택되었을 수 있습니다. 이 경우 이 함수가 실패합니다(LINEERR_INCOMPATIBLEEXTVERSION 반환).
확장 버전을 선택한 후 줄에 대한 후속 작업은 해당 확장 버전에 따라 작동합니다. 확장 버전에 대한 후속 협상 시도는 선택한 버전 또는 0을 엄격하게 보고합니다(요청된 범위에 선택한 버전이 포함되지 않은 경우). 특수 확장 버전 0으로 이 프로시저를 호출하면 현재 선택 영역이 취소됩니다. 디바이스는 다시 한 번 확장 버전 번호의 전체 범위를 지원할 수 있게 됩니다.
이 함수는 LINEOpen의 다른 기능과 함께 확장 버전을 선택하는 것이 번들로 제공되는 TAPI 수준에서 직접 대응하지 않습니다. TSPI_lineSelectExtVersion 함수는 일반적으로 두 가지 상황에서 호출됩니다. (1) 애플리케이션이 줄을 열도록 요청했고, 미디어 형식 모니터링의 결과 변경이 성공했으며, 애플리케이션이 특정 확장 버전을 사용하도록 요청했으며, 현재 확장 버전이 선택되지 않았습니다. (2) 특정 확장 버전을 사용하는 마지막 애플리케이션이 줄을 닫았고 확장 버전 선택을 취소할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | tspi.h |