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