funzione lineGetID (tapi.h)

Articolo
08/26/2023

La funzione lineGetID restituisce un identificatore del dispositivo per la classe di dispositivo specificata associata alla riga, all'indirizzo o alla chiamata selezionata.

Sintassi

LONG lineGetID(
  HLINE       hLine,
  DWORD       dwAddressID,
  HCALL       hCall,
  DWORD       dwSelect,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

Parametri

hLine

Gestire in un dispositivo a riga aperta.

dwAddressID

Indirizzo nel dispositivo open line specificato. Un identificatore di indirizzo è associato definitivamente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.

hCall

Gestire una chiamata.

dwSelect

Specifica se l'identificatore del dispositivo richiesto è associato alla riga, all'indirizzo o a una singola chiamata. Questo parametro usa uno e solo uno dei costanti LINECALLSELECT_.

lpDeviceID

Puntatore a una posizione di memoria di tipo VARSTRING, in cui viene restituito l'identificatore del dispositivo. Al termine della richiesta, questa posizione viene riempita con l'identificatore del dispositivo. Il formato delle informazioni restituite dipende dal metodo usato dall'API della classe di dispositivi per la denominazione dei dispositivi. Prima di chiamare lineGetID, l'applicazione deve impostare il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per restituire informazioni.

Nota Se i parametri delle dimensioni nella struttura non sono corretti, è possibile che i dati possano essere sovrascritti. Per altre informazioni sull'impostazione delle dimensioni della struttura, vedere l'argomento relativo all'allocazione della memoria .

lpszDeviceClass

Puntatore a una stringa con terminazione null che specifica la classe di dispositivo del dispositivo il cui identificatore è richiesto. Le stringhe della classe di dispositivo valide sono quelle usate nella sezione SYSTEM.INI per identificare le classi di dispositivo.

Valore restituito

Restituisce zero se la richiesta ha esito positivo o un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

LINEERR_INVALLINEHANDLE, LINEERR_NOMEM, LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSELECT LINEERR_INVALDEVICECLASS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NODEVICE, LINEERR_UNINITIALIZED.

Commenti

La funzione lineGetID può essere usata per recuperare un identificatore del dispositivo linea quando viene specificato un handle di riga. Ciò è utile dopo che lineOpen è stato aperto usando LINEMAPPER come identificatore del dispositivo per determinare l'identificatore reale del dispositivo linea della riga aperta. Questa funzione può essere usata anche per ottenere l'identificatore del dispositivo di un dispositivo telefonico o di un dispositivo multimediale (per classi di dispositivi come COM, wave, MIDI, telefono, linea o NDIS) associato a una chiamata, indirizzo o riga. Questo identificatore può quindi essere usato con l'API appropriata (ad esempio telefono, MIDI, onda) per selezionare il dispositivo multimediale corrispondente associato alla chiamata specificata.

Vedere Classi di dispositivo TAPI per i nomi delle classi di dispositivo.

Un fornitore che definisce una modalità multimediale specifica del dispositivo deve anche definire l'API specifica del dispositivo (proprietario) corrispondente per gestire i dispositivi della modalità multimediale. Per evitare collisioni sui nomi delle classi di dispositivo assegnati in modo indipendente dai diversi fornitori, un fornitore deve selezionare un nome che identifica in modo univoco sia il fornitore che, seguendolo, il tipo di supporto. Ad esempio: "intel/video".