phoneGetID 函式 (tapi.h)

發行項
03/02/2024

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

語法

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

參數

hPhone

開啟手機裝置的句柄。

lpDeviceID

VARSTRING 類型的數據結構的指標，其中會傳回裝置標識碼。成功完成要求時，此位置會填入裝置標識碼。傳回資訊的格式取決於裝置類別所使用的方法， (API) 命名裝置。

lpszDeviceClass

Null 終止字串的指標，指定要求標識碼之裝置的裝置類別。有效的裝置類別字串是在 System.ini 區段中用來識別裝置類別的字串。

傳回值

如果要求成功，則傳回零，如果發生錯誤，則傳回負錯誤號碼。可能的傳回值為：

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPOINTER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALDEVICECLASS、PHONEERR_UNINITIALIZED、PHONEERR_OPERATIONFAILED、PHONEERR_STRUCTURETOOSMALL PHONEERR_OPERATIONUNAVAIL。

備註

phoneGetID 函式可用來擷取指定電話句柄的手機裝置標識碼。它也可以用來取得裝置類別的媒體裝置標識碼 (，例如 COM、wave、MIDI、電話、線路或 NDIS) 與開啟的手機裝置相關聯的裝置類別。這些裝置類別的名稱不區分大小寫。此標識碼接著可與適當的媒體 API 搭配使用，以選取對應的裝置。

如需裝置類別名稱，請參閱 TAPI 裝置類別。

定義裝置特定媒體類型的廠商也需要定義對應的裝置特定 (專屬) API 來管理媒體類型的裝置。為了避免不同廠商獨立指派的裝置類別名稱發生衝突，廠商應該選取可唯一識別廠商的名稱，並在該名稱之後選取媒體類型。例如：「intel/video」。