Struttura LINEDEVSTATUS (tapi.h)
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.
Requisiti
| Intestazione | tapi.h |