(ks.h) PFNKSPIN 回呼函式
在下列情況下會呼叫 AVStream minidriver 的回呼例程:
語法
PFNKSPIN Pfnkspin;
NTSTATUS Pfnkspin(
[in] PKSPIN Pin
)
{...}
參數
[in] Pin
可處理框架數據的 KSPIN 指標。
傳回值
傳回STATUS_SUCCESS以繼續處理。 傳回STATUS_PENDING停止處理,直到下一個觸發事件為止。
備註
關於AVStrMiniPinProcess
minidriver 會在其KSPIN_DISPATCH結構的 Process 成員中指定這個例程的位址。
指出篩選條件會藉由提供此分派函式來使用 針腳中心處理 。 迷你驅動程式會在相關的 KSPIN_DESCRIPTOR_EX 結構中設定釘選旗標,以判斷 AVStream何時呼叫AVStrMiniPinProcess。 如果 minidriver 在描述元中未設定任何旗標,則預設行為是當新數據抵達先前空白佇列時 ,AVStream 會呼叫 AVStrMiniPinProcess 。 如需處理觸發程式的詳細資訊,請參閱 Pin-Centric 處理。
處理之後,迷你驅動程式可以藉由複製前置邊緣數據流指標來防止框架完成。 若要這樣做,請呼叫 KsStreamPointerClone。 請參閱前置和尾端邊緣 Stream 指標。
或者,在 KSPIN_DESCRIPTOR_EX 上設定KSPIN_FLAG_DISTINCT_TRAILING_EDGE,以指定不同的尾端邊緣。 第三個選項不是前進到前置邊緣數據流指標。
進程分派是在預設 IRQL = PASSIVE_LEVEL進行,或者,如果迷你驅動程式 已在相關KSPIN_DESCRIPTOR_EX中指定KSPIN_FLAG_DISPATCH_LEVEL_PROCESSING,可能是在DISPATCH_LEVEL。
此例程是選擇性的。
關於AVStrMiniPinConnect
minidriver 會在其KSPIN_DISPATCH結構的 Connect 成員中指定這個例程的位址。
傳回STATUS_SUCCESS或嘗試建立內部連線時傳回的錯誤。 請勿傳回STATUS_PENDING。
此例程是選擇性的。
另請參閱 KS 針腳。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX。 |
目標平台 | 桌面 |
標頭 | ks.h (包含 Ks.h) |
IRQL | (請參閱一節) |