TSPI_lineSetDefaultMediaDetection函式 (tspi.h)

發行項
03/03/2024

TSPI_lineSetDefaultMediaDetection程式會指示服務提供者偵測指定的行的新媒體類型集合， (取代任何先前的集合) 。它也會設定一組初始媒體類型，應該在此行上監視後續呼叫 (輸入或輸出) 。

語法

LONG TSPIAPI TSPI_lineSetDefaultMediaDetection(
  HDRVLINE hdLine,
  DWORD    dwMediaModes
);

參數

hdLine

要設定媒體監視之行的句柄。

dwMediaModes

TAPI 感興趣的媒體類型 () 。此參數使用其中一個 LINEMEDIAMODE_常數：

傳回值

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

LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALMEDIAMODE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_NODRIVER LINEERR_OPERATIONUNAVAIL。

備註

TAPI 通常會呼叫此函式，以在 TAPI 層級開啟或關閉一行時，將該行的偵測到媒體類型集合更新為所有未處理 lineOpens 所選取之所有模式的聯集。如果拒絕媒體偵測，則會拒絕 lineOpen 呼叫嘗試。此程式的單一呼叫通常是未指定裝置標識碼 LINEMAPPER 之 lineOpen 呼叫的結果。 TSPI 層級永遠不會使用裝置標識碼 LINEMAPPER。

TAPI 必須計算所有用戶端所需的媒體類型聯集，並將結果傳遞至此函式。服務提供者會使用 TAPI 傳遞至此函式的集合。 TAPI 可確保 dwMediaModes 參數至少有一個位集，而且未設定保留位。服務提供者必須在媒體類型上執行任何進一步的有效檢查，例如檢查服務提供者是否確實支援任何媒體類型。如果開啟行的應用程式全都監視或不想要處理連入呼叫，則所有媒體類型的聯集可以是值 0。

TAPI 層級沒有直接對應的函式。當使用 LINEMAPPER () 以外的特定裝置識別碼呼叫時，此程式會對應至 lineOpen 程式所隱含特定行的「要求媒體類型」。