共用方式為

lineGetLineDevStatus 函式 (tapi.h)

  • 發行項

lineGetLineDevStatus 函式可讓應用程式查詢指定的開啟行裝置，以取得其目前狀態。

語法

LONG lineGetLineDevStatus(
  HLINE           hLine,
  LPLINEDEVSTATUS lpLineDevStatus
);

參數

hLine

要查詢之開啟行裝置的句柄。

lpLineDevStatus

LINEDEVSTATUS 類型的可變大小數據結構的指標。 成功完成要求時，此結構會填入該行的裝置狀態。 在呼叫 lineGetLineDevStatus之前，應用程式應該設定此結構的 dwTotalSize 成員，以指出TAPI可用來傳回資訊的記憶體數量。

傳回值

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

LINEERR_INVALLINEHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL、LINEERR_NOMEM、LINEERR_UNINITIALIZED、LINEERR_OPERATIONFAILED LINEERR_OPERATIONUNAVAIL。

備註

應用程式會使用 lineGetLineDevStatus 來查詢線路裝置的目前行狀態。 此狀態資訊會全域套用至線路裝置上的所有位址。 使用 lineGetAddressStatus 來判斷某行上特定地址的狀態資訊。

規格需求

需求 值
目標平台 Windows
標頭 tapi.h
程式庫 Tapi32.lib
Dll Tapi32.dll

另請參閱

基本電話語音服務參考

LINEDEVSTATUS

TAPI 2.2 參考概觀

lineGetAddressStatus