KsFilterAttemptProcessing 函式 (ks.h)
KsFilterAttemptProcessing 函式會嘗試在 Filter 上起始處理。
語法
void KsFilterAttemptProcessing(
[in] PKSFILTER Filter,
[in] BOOLEAN Asynchronous
);
參數
[in] Filter
KSFILTER 結構的指標,代表要嘗試處理的AVStream篩選物件。
[in] Asynchronous
此參數包含一個指示,指出處理分派是否應該以異步方式發生, (是否應該在) 發生。 如果這是 TRUE,則保證異步分派;不過,同步處理分派是由以下所述的條件所控管。
傳回值
無
備註
如果 minidriver 在符合處理數據所需的所有條件時呼叫 KsFilterAttemptProcessing ,就會發生處理分派。 如需進程回呼的詳細資訊,請參閱 KSFILTER_DISPATCH。 為了讓嘗試產生實際分派,篩選的進程控制網關必須處於開啟狀態。 不同於以針腳為中心的處理,篩選中心處理有許多會影響進程控制網關的條件。 如需這些需求的詳細資訊,請參閱 篩選中心處理 和 針腳中心處理。
如果進程控制閘道已開啟,則會以同步或異步方式發生處理分派。 如果呼叫端在異步參數中指定 TRUE,處理分派一律會在工作專案中以異步方式發生。 不過,如果呼叫端要求同步處理分派,則只有在系統目前位於 minidriver 可以處理處理的 IRQL 時,才會同步進行分派。 如果系統位於PASSIVE_LEVEL,則保證分派會同步發生。 相反地,如果系統位於DISPATCH_LEVEL,則只有在篩選上指定KSFILTER_FLAG_DISPATCH_LEVEL_PROCESSING時,才會同步執行分派。 否則,工作專案會排入佇列以執行處理。
請注意,這隻是嘗試處理;呼叫此函式不保證會開始處理。 只有在進程控制閘道為「開啟」時,才會進行處理。如需詳細資訊,請參閱 在AVStream中重新啟動處理 和 AVStream中的流程控制網關。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX 版本。 |
目標平台 | Universal |
標頭 | ks.h (包含 Ks.h) |
程式庫 | Ks.lib |
IRQL | <=DISPATCH_LEVEL |