função TSPI_lineGetLineDevStatus (tspi.h)

  • Artigo

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

Confira também

LINEDEVSTATUS

TSPI_lineGetAddressStatus