FwpsFlowAssociateContext0 函式 （fwpsk.h）
FwpsFlowAssociateContext0 函式會將圖說文字驅動程式定義的內容與數據流產生關聯。
語法
NTSTATUS FwpsFlowAssociateContext0(
[in] UINT64 flowId,
[in] UINT16 layerId,
[in] UINT32 calloutId,
[in] UINT64 flowContext
);
參數
[in] flowId
運行時間標識碼，指定要與內容產生關聯的數據流。 數據流的運行時間標識符會透過傳遞至圖說文字驅動程式的FWPS_METADATA_FIELD_FLOW_HANDLE元數據值提供給圖說文字驅動程式，分類Fn 圖說函式。
[in] layerId
與內容相關聯之篩選層的運行時間標識符。 內容只會與指定的篩選層相關聯。 如需詳細資訊，請參閱 執行時間篩選層識別碼。
[in] calloutId
篩選引擎中圖說文字的運行時間標識碼。 呼叫 FwpsCalloutRegister0、FwpsCalloutRegister1或 FwpsCalloutRegister2 函式以向篩選引擎註冊圖說文字時，會傳回此標識符。
[in] flowContext
要與數據流相關聯的圖說文字驅動程式定義內容。 此參數不得為零。 此內容不透明於篩選引擎。
傳回值
FwpsFlowAssociateContext0 函式會傳回下列其中一個 NTSTATUS 程式代碼。
| 傳回碼 | 描述 |
|---|---|
|
內容已成功與數據流相關聯。 |
|
flowContext 參數是 NULL，或是 calloutID 參數所指定的圖說文字沒有註冊 flowDeleteFn。 |
|
內容已經與數據流相關聯。 在此情況下，圖說文字驅動程式應該先呼叫 FwpsFlowRemoveContext0 函式來移除現有的內容，然後再次呼叫 FwpsFlowAssociateContext0 函式，以將新內容與數據流產生關聯。 |
|
發生錯誤。 |
言論
篩選數據流時，圖說驅動程式可以呼叫 FwpsFlowAssociateContext0 函式，將內容與數據流產生關聯。 然後，它可以使用此內容來保留篩選引擎對圖說文字 針對該數據流分類Fn 圖說函式之間的任何驅動程式特定數據或狀態資訊。
layerId 參數所識別之層的篩選引擎中必須有圖說文字，該參數已註冊 flowDeleteFn 圖說函式。 否則，FwpsFlowAssociateContext0 函式的呼叫將會傳回STATUS_INVALID_PARAMETER。 篩選引擎會在流程終止時呼叫 flowDeleteFn 圖說函式，讓圖說驅動程式可以清除與流程相關聯的內容。
您可以針對相同的流程呼叫 FwpsFlowAssociateContext0 多次。 在每個通話中，您必須指定不同的圖說文字和不同的內容，每個新增的圖說文字各一個內容。
FwpsFlowAssociateContext0 函式會將單一內容與單一新增的圖說文字產生關聯。
您可以將多個內容與流程產生關聯。 不過，每個內容都必須與不同的圖說文字相關聯。 新的圖說文字可以位於與上一個或不同圖層相同的圖層。
如需詳細資訊和範例程式代碼，請參閱 關聯內容與數據流 和 Windows 篩選平臺範例。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 從 Windows Vista 開始提供。 |
| 目標平臺 | 普遍 |
| 標頭 | fwpsk.h （包括 Fwpsk.h） |
| 連結庫 | Fwpkclnt.lib |
| IRQL | <= DISPATCH_LEVEL |