Funzione phoneGetIDA (tapi.h)

La funzione phoneGetID restituisce un identificatore del dispositivo per la classe di dispositivo specificata associata al dispositivo telefonico specificato.

Sintassi

LONG phoneGetIDA(
  HPHONE      hPhone,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

Parametri

hPhone

Handle 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 di dispositivo.

Valore restituito

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

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONFAILED, PHONEERR_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL.

Osservazioni

La funzione phoneGetID può essere usata per recuperare un identificatore del dispositivo telefonico in base a un handle telefonico. 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 dispositivi 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, in seguito, il tipo di supporto. Ad esempio: "intel/video".

Nota

L'intestazione tapi.h definisce phoneGetID 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

funzioni supplementari del servizio telefonico

panoramica dei riferimenti TAPI 2.2

VARSTRING