função TSPI_lineGetLineDevStatus (tspi.h)
A função TSPI_lineGetLineDevStatus consulta o dispositivo de linha aberta especificado para seu status atual. As informações retornadas são globais para todos os endereços na linha.
Sintaxe
LONG TSPIAPI TSPI_lineGetLineDevStatus(
HDRVLINE hdLine,
LPLINEDEVSTATUS lpLineDevStatus
);
Parâmetros
hdLine
O identificador do provedor de serviços para a linha a ser consultada.
lpLineDevStatus
Um ponteiro para uma estrutura de dados de tamanho variável do tipo LINEDEVSTATUS. Essa estrutura é preenchida com o dispositivo da linha status.
Retornar valor
Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:
LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
Comentários
A tabela a seguir indica quais membros da estrutura de dados LINEDEVSTATUS são preenchidos pelo TAPI e que são preenchidos pelo provedor de serviços. O provedor de serviços deve preservar (não deve substituir) os valores preenchidos pelo TAPI.
| Nome do membro | TAPI | Provedor de serviços |
|---|---|---|
| Dwtotalsize; | X | |
| Dwneededsize; | X | |
| dwUsedSize; | X | |
| dwNumOpens; | X | |
| dwOpenMediaModes; | X | |
| dwNumActiveCalls; | X | |
| dwNumOnHoldCalls; | X | |
| dwNumOnHoldPendCalls; | X | |
| dwLineFeatures; | X | |
| dwNumCallCompletions; | X | |
| dwRingMode; | X | |
| dwSignalLevel; | X | |
| dwBatteryLevel; | X | |
| dwRoamMode; | X | |
| dwDevStatusFlags; | X | |
| dwTerminalModesSize; | X | |
| dwTerminalModesOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |