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

Panoramica dei riferimenti a TAPI 2.2

VARSTRING