TSPI_lineGetDevCaps 함수(tspi.h)
TSPI_lineGetDevCaps 함수는 지정된 줄 디바이스를 쿼리하여 전화 통신 기능을 확인합니다. 반환된 정보는 줄 디바이스의 모든 주소에 유효합니다.
구문
LONG TSPIAPI TSPI_lineGetDevCaps(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwExtVersion,
LPLINEDEVCAPS lpLineDevCaps
);
매개 변수
dwDeviceID
쿼리할 줄 디바이스입니다.
dwTSPIVersion
협상된 TSPI 버전 번호입니다. 이 값은 TSPI_lineNegotiateTSPIVersion 함수를 통해 이 디바이스에 대해 이미 협상되었습니다.
dwExtVersion
협상된 확장 버전 번호입니다. 이 값은 이미 TSPI_lineNegotiateExtVersion 함수를 통해 이 디바이스에 대해 협상되었습니다. 이 함수가 호출될 때 TAPI에서 이 매개 변수의 유효성을 검사하지 않습니다.
lpLineDevCaps
LINEDEVCAPS 형식의 고정 크기 구조체에 대한 포인터입니다. 요청이 성공적으로 완료되면 이 구조는 줄 디바이스 기능 정보로 채워집니다.
반환 값
함수가 성공하면 0을 반환하고 오류가 발생하면 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.
LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.
설명
서비스 공급자에 대한 선 디바이스 식별자 번호 매기기는 TSPI_providerInit 함수에 전달되는 dwLineDeviceIDBase 매개 변수에 의해 설정된 값에서 순차적으로 표시됩니다.
dwExtVersion 정식 매개 변수는 요청된 확장 정보의 버전 번호를 나타냅니다. 0이면 확장 정보가 요청되지 않습니다. 0이 아닌 경우 TSPI_lineNegotiateExtVersion 함수를 사용하여 이 디바이스에 대해 협상된 값을 보유합니다. 서비스 공급자는 지정된 확장 버전에 따라 디바이스 및 공급업체별 확장 정보를 채웁니다.
서비스 공급자는 TAPI로 채워진 dwTotalSize를 제외하고 LINEDEVCAPS 데이터 구조의 모든 멤버를 채웁니다. 서비스 공급자는 dwTotalSize 멤버를 덮어쓰지 않아야 합니다.
서비스 공급자는 LINETERMCAPS 데이터 구조의 모든 멤버 또는 LINEDEVCAPS 데이터 구조의 다양한 부분에 포함된 구조체를 채워야 합니다.
서비스 공급자가 TSPI_lineGetDevCaps 함수에서 반환한 후 TAPI는 LINEDEVCAPS 구조체의 dwLinesStates 멤버를 다음과 같이 설정합니다.
LINEDEVCAPS.dwLineStates |=
LINEDEVSTATE_OPEN |
LINEDEVSTATE_CLOSE |
LINEDEVSTATE_REINIT |
LINEDEVSTATE_TRANSLATECHANGE;
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | tspi.h |