TSPI_phoneGetID函式 (tspi.h)

TSPI_phoneGetID函式會傳回與指定電話裝置相關聯的指定裝置類別的裝置識別碼。

語法

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

參數

hdPhone

要查詢之電話的句柄。

lpDeviceID

VARSTRING 類型的數據結構的指標，其中會傳回裝置標識碼。 傳回資訊的格式取決於裝置類別所使用的方法， (API) 來命名裝置。 在呼叫 TSPI_phoneGetID之前，應用程式會設定這個結構的 dwTotalSize 成員，以指出 TAPI 可用來傳回資訊的記憶體數量。

lpszDeviceClass

Null 終止 Unicode 字串的指標，指定要求標識碼之裝置的裝置類別。

hTargetProcess

正在叫用 TSPI_phoneGetID 函式的應用程式進程句柄。 如果 VARSTRING 結構中傳回的資訊包含應用程式的使用句柄，服務提供者會建立或複製進程的句柄。

傳回值

如果函式成功，則傳回零，如果發生錯誤，則傳回錯誤號碼。 可能的傳回值如下所示：

PHONEERR_INVALPHONEHANDLE、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALDEVICECLASS、PHONEERR_OPERATIONFAILED、PHONEERR_NOMEM PHONEERR_OPERATIONUNAVAIL。

備註

這項作業可用來擷取指定電話句柄的手機裝置標識碼。 它也可以用來取得與已開啟電話裝置相關聯之裝置類別的媒體裝置 (裝置標識碼，例如 COM、wave、MIDI、phone、line 和 mciwave) 。 然後，此標識碼可以搭配適當的媒體 API (使用，例如mci、midi和 wav) ，以選取對應的裝置。 如需常見裝置類別名稱的詳細資訊，請參閱 TSPI 裝置類別。

服務提供者會填入 VARSTRING 數據結構的所有成員，但 dwTotalSize 除外，而 DWTotalSize 則由 TAPI 填入。 服務提供者不得覆寫 dwTotalSize 成員。

服務提供者不需要擔心處理 tapi/line 和 tapi/phone 裝置類別，因為 TAPI 會處理服務提供者的這些類別。 因此，處理這些裝置類別的程式代碼是選擇性的。

規格需求

需求	值
目標平台	Windows
標頭	tspi.h

另請參閱

VARSTRING