Struttura LINEDEVSTATUS (tapi.h)

Articolo
08/26/2023

La struttura LINEDEVSTATUS descrive lo stato corrente di un dispositivo linea. La funzione lineGetLineDevStatus e la funzione TSPI_lineGetLineDevStatus restituiscono la struttura LINEDEVSTATUS .

Sintassi

typedef struct linedevstatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwNumOpens;
  DWORD dwOpenMediaModes;
  DWORD dwNumActiveCalls;
  DWORD dwNumOnHoldCalls;
  DWORD dwNumOnHoldPendCalls;
  DWORD dwLineFeatures;
  DWORD dwNumCallCompletions;
  DWORD dwRingMode;
  DWORD dwSignalLevel;
  DWORD dwBatteryLevel;
  DWORD dwRoamMode;
  DWORD dwDevStatusFlags;
  DWORD dwTerminalModesSize;
  DWORD dwTerminalModesOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwAvailableMediaModes;
  DWORD dwAppInfoSize;
  DWORD dwAppInfoOffset;
} LINEDEVSTATUS, *LPLINEDEVSTATUS;

Members

dwTotalSize

Dimensioni totali allocate a questa struttura di dati, in byte.

dwNeededSize

Dimensioni per questa struttura di dati necessaria per contenere tutte le informazioni restituite, in byte.

dwUsedSize

Dimensioni della parte di questa struttura di dati che contiene informazioni utili, in byte.

dwNumOpens

Numero di apertura attive nel dispositivo line.

dwOpenMediaModes

Matrice di bit che indica per quali tipi di supporti il dispositivo linea è attualmente aperto.

dwNumActiveCalls

Numero di chiamate sulla riga in stati di chiamata diversi da inattività, onhold, onholdpendingtransfer e onholdpendingconference.

dwNumOnHoldCalls

Numero di chiamate sulla riga nello stato di ritenuta .

dwNumOnHoldPendCalls

Numero di chiamate sulla riga nello stato onholdpendingtransfer o onholdpendingconference .

dwLineFeatures

Funzioni correlate alla riga attualmente disponibili in questa riga. Questo membro usa una o più costanti LINEFEATURE_.

dwNumCallCompletions

Numero di richieste di completamento delle chiamate in sospeso nella riga.

dwRingMode

Modalità circolare corrente nel dispositivo line.

dwSignalLevel

Livello di segnale corrente della connessione sulla linea. Si tratta di un valore nell'intervallo 0x00000000 (segnale più debole) da 0x0000FFFF (segnale più forte).

dwBatteryLevel

Livello corrente della batteria dell'hardware del dispositivo line. Si tratta di un valore nell'intervallo 0x00000000 (batteria vuota) per 0x0000FFFF (batteria piena).

dwRoamMode

Modalità di roaming corrente del dispositivo linea. Questo membro usa una delle costanti LINEROAMMODE_.

dwDevStatusFlags

Flag che indicano informazioni sullo stato, ad esempio se il dispositivo è bloccato. È costituito da uno o più membri di costanti LINEDEVSTATUSFLAGS_.

dwTerminalModesSize

Dimensioni del campo dispositivo di dimensioni variabile contenente una matrice di modalità terminale correnti, in byte.

dwTerminalModesOffset

Offset dall'inizio della struttura a una matrice di modalità terminale correnti, in byte. Questa matrice viene indicizzata in base agli ID del terminale, nell'intervallo compreso tra zero e dwNumTerminals meno uno. Ogni voce nella matrice specifica le modalità terminale correnti per il set di terminale corrispondente usando la funzione lineSetTerminal per questa riga. Ogni voce è una DWORD che specifica una o più costanti LINETERMMODE_. Le dimensioni della matrice sono specificate da dwTerminalModesSize.

dwDevSpecificSize

Dimensioni del campo specifico del dispositivo di dimensioni variabili, in byte. Se le informazioni specifiche del dispositivo sono un puntatore a una stringa, la dimensione deve includere il carattere di terminazione Null .

dwDevSpecificOffset

Offset dall'inizio della struttura al campo specifico del dispositivo, in byte. Le dimensioni del campo vengono specificate da dwDevSpecificSize.

dwAvailableMediaModes

Indica i tipi di supporti che possono essere richiamati in nuove chiamate create in questo dispositivo line, quando il membro dwLineFeatures indica che sono possibili nuove chiamate. Se questo membro è zero, indica che il provider di servizi non conosce o non può indicare quali tipi di supporti sono disponibili, nel qual caso uno o tutti i tipi di supporti indicati nel membro dwMediaModes in LINEDEVCAPS potrebbero essere disponibili.

dwAppInfoSize

Dimensione della matrice che identifica le applicazioni con la riga aperta, in byte.

dwAppInfoOffset

Offset dall'inizio della struttura a una matrice di strutture LINEAPPINFO . Il membro dwNumOpens indica il numero di elementi nella matrice. Ogni elemento nella matrice identifica un'applicazione con la riga aperta. Le dimensioni della matrice sono specificate da dwAppInfoSize.

Commenti

Le estensioni specifiche del dispositivo devono usare l'area di dimensioni variabili DevSpecific (dwDevSpecificSize e dwDevSpecificOffset) di questa struttura di dati.

I membri dwAvailableMediaModes tramite dwAppInfoOffset sono disponibili solo per le applicazioni che aprono il dispositivo line con una versione API 2.0 o successiva.