KsPinGetLeadingEdgeStreamPointer 函式 （ks.h）
KsPinGetLeadingEdgeStreamPointer 函式會取得與指定針腳相關聯之佇列的前置邊緣數據流指標。
語法
KSDDKAPI PKSSTREAM_POINTER KsPinGetLeadingEdgeStreamPointer(
[in] PKSPIN Pin,
[in] KSSTREAM_POINTER_STATE State
);
參數
[in] Pin
KSPIN 的指標 結構，其擁有應取得前置邊緣數據流指標的佇列。
[in] State
此參數會指定如何取得前置邊緣數據流指標。 可以是下列其中一項：
KSSTREAM_POINTER_STATE_UNLOCKED
不論其是否參考數據框架，都取得前置邊緣數據流指標。
在指標鎖定之前，無法嘗試存取與指標相關聯的任何數據。 另請注意，可以取消與解除鎖定數據流指標相關聯的畫面格。
KSSTREAM_POINTER_STATE_LOCKED
取得並鎖定前置邊緣數據流指標。 如果沒有與資料串流指標相關聯的資料框架，請 NULL傳回 。 如果傳回非null 指標，則它是鎖定的數據流指標，且具有與其相關聯的數據框架。 無法取消與鎖定數據流指標相關聯的框架， 無法取消。
傳回值
KsPinGetLeadingEdgeStreamPointer 會傳回 KSSTREAM_POINTER 結構的指標，或 NULL。 可能會發生 null NULL 的傳回值，因為沒有與針腳相關聯的佇列，表示針腳不會使用標準傳輸機制。 或者，可能會因為嘗試鎖定前置邊緣失敗而發生 NULL 的傳回值，表示沒有與前置邊緣相關聯的數據框架。
言論
實作 Pin-Centric 處理 的篩選條件通常會呼叫 KsPinGetLeadingEdgeStreamPointer。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。 |
| 目標平臺 | 普遍 |
| 標頭 | ks.h （包括 Ks.h） |
| 連結庫 | Ks.lib |
| IRQL | <=DISPATCH_LEVEL |
另請參閱
KsPinGetTrailingEdgeStreamPointer