共用方式為

TcAddFlow 函式 (traffic.h)

  • 發行項

TcAddFlow函式會在指定的介面上加入新的流程。 請注意，成功新增流程不一定表示流量處理方式的變更;流量處理變更會藉由使用 TcAddFilter 函式將篩選附加至新增的流程而受到影響。

已註冊 AddFlowComplete 處理常式的流量控制用戶端 (允許流量控制呼叫 ClAddFlowComplete 回呼函式的機制，以警示用戶端完成的流程新增) 可能會預期傳回值ERROR_SIGNAL_PENDING。 如需詳細資訊，請參閱 流量控制物件。

語法

ULONG TcAddFlow(
  [in]  HANDLE       IfcHandle,
  [in]  HANDLE       ClFlowCtx,
  [in]  ULONG        Flags,
  [in]  PTC_GEN_FLOW pGenericFlow,
  [out] PHANDLE      pFlowHandle
);

參數

[in] IfcHandle

與要加入流程之介面相關聯的控制碼。 這個控制碼是由 先前呼叫 TcOpenInterface 函式所取得。

[in] ClFlowCtx

用戶端提供的流程內容控制碼。 在參考新增的流程時，流量控制會後續使用。

[in] Flags

保留供未來使用。 必須設定為零。

[in] pGenericFlow

所安裝流程描述的指標。

[out] pFlowHandle

流量控制將傳回流程控制碼的位置指標。 此流程控制碼應該用於流量控制的後續呼叫中，以參考已安裝的流程。

傳回值

新增流程的要求可能會遭到拒絕的原因有很多。 系統會提供流量控制從呼叫 TcAddFlow 傳回的錯誤碼，以協助判斷拒絕的原因。

傳回碼 描述
NO_ERROR
 未發生錯誤的函式執行。
ERROR_SIGNAL_PENDING
 函式正以非同步方式執行;用戶端會在新增流程或進程完成時，透過用戶端公開的 ClAddFlowComplete 函式來回呼叫。
ERROR_INVALID_HANDLE
 介面控制碼無效。
ERROR_NOT_ENOUGH_MEMORY
 系統記憶體不足。
ERROR_INVALID_PARAMETER
 有一個參數無效。
ERROR_INVALID_SERVICE_TYPE
 已提供未指定或不正確的 INTSERV 服務類型。
ERROR_INVALID_TOKEN_RATE
 已提供未指定或不正確的 TOKENRATE 值。
ERROR_INVALID_PEAK_RATE
 PEAKBANDWIDTH 值無效。
ERROR_INVALID_SD_MODE
 SHAPEDISCARDMODE 無效。
ERROR_INVALID_QOS_PRIORITY
 優先順序值無效。
ERROR_INVALID_TRAFFIC_CLASS
 流量類別值無效。
ERROR_NO_SYSTEM_RESOURCES
 沒有足夠的資源可容納要求的流程。
ERROR_TC_OBJECT_LENGTH_INVALID
 為 TC 物件指定的長度不正確。
ERROR_INVALID_DIFFSERV_FLOW
 適用于 Diffserv 流程。 表示 QOS_DIFFSERV 物件是以不正確參數傳遞。
ERROR_DS_MAPPING_EXISTS
 適用于 Diffserv 流程。 表示 TC_GEN_FLOW 中指定的QOS_DIFFSERV_RULE已套用至介面上的現有流程。
ERROR_INVALID_SHAPE_RATE
 QOS_SHAPING_RATE物件已傳遞無效的 ShapingRate成員。
ERROR_INVALID_DS_CLASS
 QOS_DS_CLASS無效。
ERROR_NETWORK_UNREACHABLE
 網路纜線未插入介面卡。

備註

如果 TcAddFlow 函式傳回ERROR_SIGNAL_PENDING， ClAddFlowComplete 函式將會在與呼叫 TcAddFlow 函式的執行緒不同的執行緒上呼叫。

只有新增篩選會影響流量控制。 不過，新增流程會導致在流量控制元件內認可資源。 這可讓流量控制準備處理新增流程上的流量。

流量控制可能會因為各種原因而刪除流程，包括無法因頻寬限制而容納流程，以及調整的原則需求。 用戶端會透過 ClNotifyHandler 回呼函式收到已刪除流程的通知，其中包含 TC_NOTIFY_FLOW_CLOSE 事件。

注意 使用 TcAddFlow 函式需要系統管理許可權。
 

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 traffic.h
程式庫 Traffic.lib
Dll Traffic.dll

另請參閱

ClAddFlowComplete

ClNotifyHandler

TC_GEN_FLOW

TcAddFilter

TcOpenInterface