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 |