共用方式為


(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 (請參閱一節)

另請參閱

篩選中心處理

KSPIN_DESCRIPTOR_EX

KSPIN_DISPATCH

KsStreamPointerClone

釘選中心處理