funzione TSPI_phoneGetID (tspi.h)

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

Sintassi

LONG TSPIAPI TSPI_phoneGetID(
  HDRVPHONE   hdPhone,
  LPVARSTRING lpDeviceID,
  LPCWSTR     lpszDeviceClass,
  HANDLE      hTargetProcess
);

Parametri

hdPhone

Handle per il telefono su cui eseguire una query.

lpDeviceID

Puntatore a una struttura di dati di tipo VARSTRING in cui viene restituito l'identificatore del dispositivo. Il formato delle informazioni restituite dipende dal metodo usato dalla classe di dispositivo (API) per la denominazione dei dispositivi. Prima di chiamare TSPI_phoneGetID, l'applicazione imposta il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per la restituzione di informazioni.

lpszDeviceClass

Puntatore a una stringa Unicode con terminazione Null che specifica la classe di dispositivo del dispositivo il cui identificatore è richiesto.

hTargetProcess

Handle del processo dell'applicazione per conto del quale viene richiamata la funzione TSPI_phoneGetID . Se le informazioni restituite nella struttura VARSTRING includono un handle per l'uso da parte dell'applicazione, il provider di servizi crea o duplica l'handle per il processo.

Valore restituito

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

PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.

Commenti

Questa operazione 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 e mciwave) associato al dispositivo telefonico aperto. Questo identificatore può quindi essere usato con l'API multimediale appropriata (ad esempio mci, midi e wav) per selezionare il dispositivo corrispondente. Per altre informazioni sui nomi comuni delle classi di dispositivi, vedere Classi di dispositivi TSPI.

Il provider di servizi compila tutti i membri della struttura dei dati VARSTRING , ad eccezione di dwTotalSize, compilato da TAPI. Il provider di servizi non deve sovrascrivere il membro dwTotalSize .

Il provider di servizi non deve preoccuparsi della gestione delle classi di dispositivi tapi/line e tapi/phone perché TAPI gestisce queste classi per il provider di servizi. Di conseguenza, il codice per la gestione di queste classi di dispositivi è facoltativo.

Requisiti

Vedi anche

VARSTRING