Funzione phoneGetID (tapi.h)
La funzione phoneGetID restituisce un identificatore del dispositivo per la classe di dispositivo specificata associata al dispositivo telefonico specificato.
Sintassi
LONG phoneGetID(
HPHONE hPhone,
LPVARSTRING lpDeviceID,
LPCSTR lpszDeviceClass
);
Parametri
hPhone
Gestire in un dispositivo telefonico aperto.
lpDeviceID
Puntatore a una struttura di dati di tipo VARSTRING in cui 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 dalla classe di dispositivo (API) per la denominazione dei dispositivi.
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 nella sezione System.ini per identificare le classi del dispositivo.
Valore restituito
Restituisce zero se la richiesta ha esito positivo o negativo se si verifica un errore. I valori restituiti possibili sono:
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONFAILED, PHONEERR_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL.
Commenti
La funzione phoneGetID può essere usata per recuperare un identificatore del dispositivo telefonico in base a un handle di telefono. Può anche essere usato per ottenere l'identificatore del dispositivo multimediale (per classi di dispositivi come COM, wave, MIDI, telefono, linea o NDIS) associato al dispositivo telefonico aperto. I nomi di queste classi di dispositivo non fanno distinzione tra maiuscole e minuscole. Questo identificatore può quindi essere usato con l'API multimediale appropriata per selezionare il dispositivo corrispondente.
Vedi Classi di dispositivi TAPI per i nomi delle classi di dispositivi.
Un fornitore che definisce un tipo di supporto specifico del dispositivo deve anche definire l'API (proprietaria) specifica del dispositivo corrispondente per gestire i dispositivi del tipo di supporto. 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, seguendolo, il tipo di supporto. Ad esempio: "intel/video".
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi.h |
| Libreria | Tapi32.lib |
| DLL | Tapi32.dll |
Vedi anche
Funzioni supplementari del servizio telefonico