KsPinAttemptProcessing 函式 (ks.h)
KsPinAttemptProcessing 函式是用來繼續處理釘選中心篩選上的特定針腳。 它會嘗試在 Pin 上起始處理,方法是將處理分派呼叫傳送至 Pin 的處理物件。
語法
void KsPinAttemptProcessing(
[in] PKSPIN Pin,
[in] BOOLEAN Asynchronous
);
參數
[in] Pin
KSPIN 結構的指標,表示要嘗試處理的AVStream釘選物件。
警告
此為必要參數。 如果您以 PIN 值為 NULL 呼叫 KsPinAttemptProcessing,系統不穩定可能會造成。
[in] Asynchronous
此參數指出迷你驅動程式的喜好設定是應該以同步或異步方式進行處理。 如果 為 TRUE,則處理一律為異步。 不過,同步處理只會在特定情況下發生。 如需詳細資訊,請參閱下面的<備註>一節。
傳回值
無
備註
迷你驅動程式可能需要呼叫 KsPinAttemptProcessing,以在各種情況下繼續處理。 例如,如果用戶端已關閉 KsGateTurnInputOff 的處理控制閘道,請在準備好嘗試處理時呼叫此函式。 請注意,只有在進程控制網關處於開啟狀態時,才會造成處理分派。 另一種情況牽涉到迷你驅動程式先前已將STATUS_PENDING傳回處理分派。 如需詳細資訊,請參閱 在AVStream中重新啟動處理 和 AVStream中的流量控制網關。
只有在處理控制網關開啟時,才會以同步或異步方式進行處理分派。 異步旗標會指定迷你驅動程式的喜好設定。 如果迷你驅動程式要求異步進程分派,則分派一律為異步。 不過,即使呼叫端將 異步 設定為 FALSE,只有當系統目前在 IRQL 上執行小於最大處理 IRQL 時,才會發生同步分派。 換句話說,如果迷你驅動程式未指定分派層級處理,而且呼叫是在 IRQL = DISPATCH_LEVEL進行,則不論 異步的值為何,呼叫都會在異步的工作專案中發生PASSIVE_LEVEL。 如需詳細資訊,請參閱 篩選中心處理 和 針腳中心處理。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | ks.h (包含 Ks.h) |
程式庫 | Ks.lib |
IRQL | <=DISPATCH_LEVEL (請參閱備註) |