Funzione lineGetIDA (tapi.h)

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 lineGetIDA(
  HLINE       hLine,
  DWORD       dwAddressID,
  HCALL       hCall,
  DWORD       dwSelect,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

Parametri

hLine

Handle in un dispositivo line aperto.

dwAddressID

Indirizzo nel dispositivo a riga aperta specificato. Un identificatore di indirizzo è associato in modo permanente 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 una sola costante LINECALLSELECT_.

lpDeviceID

Puntatore a una posizione di memoria di tipo VARSTRING, dove viene restituito l'identificatore del dispositivo. Al termine della richiesta, questo percorso viene compilato con l'identificatore del dispositivo. Il formato delle informazioni restituite dipende dal metodo usato dall'API della classe di dispositivo 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 di dimensione nella struttura non sono corretti, è possibile che i dati vengano sovrascritti. Per altre informazioni sull'impostazione delle dimensioni della struttura, vedere l'argomento allocazione di memoria.

 

lpszDeviceClass

Puntatore a una stringa con terminazione Null che specifica la classe di dispositivo del dispositivo il cui identificatore è richiesto. Le stringhe di classe del dispositivo valide sono quelle usate nel sistema. Sezione INI per identificare le classi di dispositivi.

Valore restituito

Restituisce zero se la richiesta ha esito positivo o negativo se si verifica un errore. I possibili valori restituiti 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.

Osservazioni

La funzione lineGetID può essere usata per recuperare un identificatore del dispositivo di riga quando viene assegnato un handle di riga. Ciò risulta utile dopo che lineOpen è stato aperto usando LINEMAPPER come identificatore di dispositivo per determinare l'identificatore reale 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, un indirizzo o una 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.

Vedi classi di dispositivi TAPI per i nomi delle classi di dispositivi.

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

Nota

L'intestazione tapi.h definisce lineGetID come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	tapi.h
libreria	Tapi32.lib
dll	Tapi32.dll

Vedere anche

di riferimento dei servizi di telefonia di base

panoramica dei riferimenti TAPI 2.2

VARSTRING

lineOpen